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Abstract 


ShipMo3D  is  an  object-oriented  library  with  associated  user  applications  for  pre¬ 
dicting  ship  motions,  with  Version  3  introducing  modelling  of  sloshing  tanks  and 
U-tube  tanks.  This  report  serves  as  a  user  manual  for  ship  motion  predictions  in 
the  time  and  frequency  domains  using  ShipMo3D  Version  3.  A  companion  report 
serves  as  a  user  manual  for  building  ship  models  that  are  used  as  input  for  ship 
motion  predictions.  Time  domain  simulations  can  model  a  freely  maneuvering  ship 
in  calm  water  or  in  waves.  SM3DBuildSeaway  builds  seaway  models  representing 
regular  or  random  seaways,  including  long  and  short-crested  seaways.  SM3DFreeMo 
simulates  a  freely  maneuvering  ship  in  calm  water  or  in  a  modelled  seaway.  Sev¬ 
eral  ShipMo3D  applications  predict  ship  motions  in  the  frequency  domain  for  a  ship 
with  quasi-steady  speed  and  heading.  SM3DSeakeepRegular  predicts  motions  in 
regular  waves.  The  applications  SM3DSeakeepRandom,  SM3DSeakeepSeaway,  and 
SM3DSeakeepSeawayFromRaos  predict  motions  in  random  waves.  SM3DTimeSeries- 
FromRaos  produces  ship  motion  time  series  for  a  ship  with  quasi-steady  speed  and 
heading  based  on  previously  predicted  motion  response  amplitude  operators. 


Resume 


ShipMo3D  est  une  bibliotheque  objet  avec  applications  utilisateur  connexes  pour 
la  prevision  des  mouvements  de  navires  dans  le  domaine  temporel  et  le  domaine 
frequentiel.  La  version  3  comprend  la  modelisation  de  citernes  a  ballottement  et  de 
citernes  a  tube  en  U.  Le  present  rapport  sert  de  manuel  de  Lutilisateur  pour  la 
prevision  du  mouvement  de  navires  dans  le  domaine  temporel  et  dans  le  domaine 
frequentiel,  a  l’aide  de  la  version  3  de  ShipMo3D.  Un  rapport  d’accompagnement 
sert  de  manuel  de  Lutilisateur  pour  la  construction  de  modeles  de  navires  qui  sont 
utilises  pour  entrer  des  donnees  sur  la  prevision  du  mouvement.  Les  simulations  du 
domaine  temporel  permettent  de  modeliser  un  navire  en  manoeuvre  libre  et  en  eau 
cal  me  ou  dans  les  vagues.  SM3DBuildSeaway  construit  des  modeles  de  voie  maritime 
a  trajet  regulier  ou  aleatoire,  y  compris  des  voies  pour  le  transport  maritime  a  courte 
ou  longue  distance.  L’application  SM3DFreeMo  simule  un  navire  manoeuvrant  libre- 
ment  en  eau  calme  ou  dans  une  voie  maritime  modelisee.  Plusieurs  applications  du 
logiciel  ShipMo3D  font  des  previsions  des  mouvements  de  navires  dans  le  domaine 
frequentiel,  pour  un  navire  a  vitesse  quasi  constante  dans  des  vagues  regulieres  et 
tenant  le  cap.  L’application  SM3DSeakeepRegular  prevoit  des  mouvements  dans  des 
vagues  regulieres.  Les  applications  SM3DSeakeepRandom,  SM3DseakeepSeaway  et 
SM3DSeakeepSeawayFromRaos  font  des  previsions  du  mouvement  dans  des  vagues 
aleatoires.  L’application  SM3DTimeSeriesFromRaos  produit  des  series  temporellcs 
du  mouvement  de  navires  pour  un  navire  a  vitesse  quasi  constante  et  tenant  le  cap, 
a  partir  d’operateur  d’amplitude  de  reponses  de  mouvements  prevues. 
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Executive  summary 


ShipMo3D  Version  3.0  User  Manual  for  Computing  Ship 
Motions  in  the  Time  and  Frequency  Domains 

Kevin  McTaggart;  DRDC  Atlantic  TM  201 1-308;  Defence  Research  and 
Development  Canada  -  Atlantic;  January  201 2. 

Introduction:  Ship  motions  influence  the  performance  and  safety  of  naval  personnel 
and  systems.  Consequently,  ship  motion  predictions  are  often  used  to  support  ship 
design  and  operation.  Time  domain  analysis  is  required  to  model  motions  if  a  ship  is 
freely  maneuvering  or  in  a  heavy  seaway.  Frequency  domain  predictions  are  compu¬ 
tationally  efficient  and  suitable  for  ships  travelling  with  steady  speed  and  heading  in 
moderate  seaways. 

Principal  Results:  ShipMo3D  is  an  object-oriented  library  with  associated  user  ap¬ 
plications  for  predicting  ship  motions  in  calm  water  and  in  waves.  Motion  predictions 
are  available  in  both  the  time  domain  and  the  frequency  domain.  For  predictions  in 
the  time  domain,  the  ship  can  be  freely  maneuvering  in  either  calm  water  or  in  waves. 
This  report  serves  as  a  user  manual  for  computing  ship  motions  using  Version  3.  A 
companion  report  provides  a  user  manual  for  creating  ship  models  required  as  input 
for  computing  motions.  ShipMo3D  Version  3  introduces  capabilities  for  modelling 
U-tube  tanks  and  sloshing  tanks. 

Significance  of  Results:  ShipMo3D  continues  to  be  suitable  for  providing  predic¬ 
tions  of  ship  motions  in  waves.  These  simulations  can  be  used  for  various  applications, 
including  engineering  analysis,  operations  analysis,  and  training. 

Future  Plans:  ShipMo3D  Version  3  will  be  incorporated  into  simulations  modelling 
naval  platform  systems  using  the  High  Level  Architecture. 
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Sommaire 


ShipMo3D  Version  3.0  User  Manual  for  Computing  Ship 
Motions  in  the  Time  and  Frequency  Domains 

Kevin  McTaggart ;  DRDC  Atlantic  TM  201 1-308 ;  Recherche  et  developpement 
pour  la  defense  Canada  -  Atlantique ;  janvier  201 2. 

Introduction  :  Les  mouvements  de  navires  ont  line  influence  sur  le  rendement  et  la 
securite  du  personnel  et  des  systemes  navals.  Par  consequent,  les  previsions  des  mou¬ 
vements  de  navires  sont  souvent  utilisees  en  appui  a  la  conception  et  a  l’exploitation 
des  navires.  L ’analyse  du  domaine  temporel  est  requise  pour  modeliser  les  mouve¬ 
ments  si  un  navire  manoeuvre  librement  on  dans  une  voie  maritime  tres  occupee.  Les 
previsions  du  domaine  frequentiel  sont  efficaces  sur  le  plan  des  calculs  et  conviennent 
aux  navires  qui  naviguent  a  vitesse  continue  et  font  cap  dans  des  voies  maritimes 
moyennement  occupees. 

Resultats  principaux  :  ShipMo3D  est  une  bibliotheque  objet  avec  applications 
utilisateur  connexes  pour  la  prevision  des  mouvements  de  navires  en  eau  calme  et  dans 
les  vagues.  Les  previsions  des  mouvements  sont  disponibles  dans  le  domaine  temporel 
et  dans  le  domaine  frequentiel.  Pour  les  previsions  dans  le  domaine  temporel,  le 
navire  peut  manoeuvrer  librement  dans  les  eaux  calmes  ou  dans  les  vagues.  Le  present 
document  sert  de  rnanuel  de  l’utilisateur  pour  calculer  les  mouvements  de  navires  a 
l’aide  de  la  version  3.  Un  rapport  d’accompagnement  sert  de  rnanuel  de  l’utilisateur 
pour  la  construction  de  modeles  de  navires  qui  sont  requis  pour  entrer  des  donnees 
servant  a  calculer  les  mouvements.  La  version  du  logicicl  ShipMo3D  introduit  des 
capacites  de  modelisation  des  citernes  a  tube  en  U  et  des  citernes  a  ballottement. 

Importance  des  resultats  :  Le  logicicl  ShipMo3D  convient  toujours  pour  la  previs¬ 
ion  des  mouvements  de  navires  dans  les  vagues.  Les  simulations  peuvent  etre  utilisees 
pour  differentes  applications,  y  compris  l’analyse  technique,  l’analyse  des  operations 
et  la  formation. 

Travaux  ulterieurs  prevus  :  La  version  3  du  logiciel  ShipMo3D  sera  integree  a  des 
simulations  modelisant  des  systemes  de  plates  formes  navales  a  l’aide  de  1’ architecture 
de  haut  niveau. 


IV 


DRDC  Atlantic  TM  2011-308 


Table  of  contents 

Abstract .  i 

Resume .  i 

Executive  summary .  iii 

Sommaire .  iv 

Table  of  contents .  v 

List  of  tables .  ix 

List  of  figures .  ix 

1  Introduction .  1 

2  New  Features  for  ShipMo3D  Version  3 .  2 

2.1  High  Frequency  Approximation  for  Evaluating  Retardation  Functions  2 

2.2  Modelling  of  U-tube  Tanks  for  Roll  Stabilization .  2 

2.3  Modelling  of  Sloshing  in  Tanks  with  Free  Surfaces .  3 

2.4  Application  SM3DSeakeepSeawayFromRaos  for  Predicting  Motions 

in  a  Seaway  Using  Input  Response  Amplitude  Operators .  3 

2.5  Prediction  of  Motion  Sickness  Incidence  in  the  Frequency  Domain  .  3 

2.6  Output  of  Motion  Response  Amplitude  Operators  for  Operability 

Analysis  Using  SHIPOP2 .  3 

3  Overview  of  Using  ShipMo3D  for  Computing  Ship  Motions .  4 

4  Coordinate  Systems .  8 

5  Building  of  Seaway  Model  -  SM3DBuildSeaway .  11 

5.1  Wave  Spectra  for  Random  Seaways  .  11 

5.1.1  Bretschneider  Spectrum .  12 

5.1.2  Three  Parameter  JONSWAP  Spectrum .  12 

DRDC  Atlantic  TM  201 1  -308  v 


5.1.3  Ochi  and  Hubble  Six  Parameter  Spectrum .  13 

5.1.4  Bretschneider  and  JONSWAP  Spectrum  with 

Cosine-Squared  Spreading  Function .  13 

5.1.5  Ten  Parameter  Directional  Spectrum .  13 

6  Motions  of  Freely  Maneuvering  Ship  in  a  Seaway  -  SM3DFreeMo .  15 

7  Ship  Seakeeping  in  a  Regular  Seaway  -  SM3DSeakeepRegular .  16 

8  Ship  Seakeeping  in  a  Random  Seaway  with  Principal  Direction  Given 

Relative  to  the  Ship  -  SM3DSeakeepRandom  .  17 

9  Ship  Seakeeping  in  a  Fixed  Seaway  with  Ship  Heading  Given  Relative  to 

Earth-Fixed  Axes  -  SM3DSeakeepSeaway  .  18 

10  Ship  Seakeeping  in  a  Fixed  Seaway  Using  Previously  Computed  Ship 

Motion  RAOs  -  SM3DSeakeepSeawayFromRaos .  19 

11  Time  Series  of  Ship  Motions  from  Response  Amplitude  Operators  - 

SM3DTimeSeriesFromRaos  .  20 

12  Inputs  for  Rudder  and  Azimuthing  Propeller  Autopilots  .  21 

13  Inputs  for  Frequency  Domain  Ship  Motion  Predictions  in  Random  Seas  .  .  22 

13.1  Wave  Spectra  .  22 

13.2  Motion-Induced  Interruptions .  22 

13.3  Slamming  Pressures  and  Forces .  22 

14  Conclusions .  28 

References .  29 

Symbols  and  Abbreviations .  32 

Annex  A:  Files  for  Building  a  Seaway  with  SM3DBuildSeaway3 .  35 

A.l  Format  of  Input  Seaway  File  for  SM3DBuildSeaway3 .  35 

A. 2  Format  of  Input  Directional  Spectrum  File  for 

SM3DBuildSeaway3 .  63 


VI 


DRDC  Atlantic  TM  2011-308 


A. 3  Sample  Input  Directional  Spectrum  File  for 

SM3DBuildSeaway3 .  66 

A. 4  Sample  Input  File  for  SM3DBuildSeaway3 .  71 

A.  5  Sample  Output  File  for  SM3DBuildSeaway3  .  72 

Annex  B:  Files  for  Simulating  Motions  of  Freely  Maneuvering  Ship  with 

SM3DFreeMo3 .  75 

B. l  Format  of  Input  File  for  Simulating  Motion  of  a  Freely 

Maneuvering  Ship  with  SM3DFreeMo3  .  75 

B.2  Sample  Input  File  for  SM3DFreeMo3  .  113 

B. 3  Sample  Output  File  for  SM3DFreeMo3  (Time  Series  Data 

Removed)  .  114 

Annex  C:  Files  for  Motions  in  a  Regular  Seaway  with  SM3DSeakeepRegular3  121 

C. l  Format  of  Input  File  for  SM3DSeakeepRegular 3  .  121 

C.2  Sample  Input  File  for  SM3DSeakeepRegular3 .  145 

C. 3  Sample  Output  File  for  SM3DSeakeepRegular3  (Motions 

Given  for  Only  One  Speed  and  Heading  Combination)  ....  146 

Annex  D:  Files  for  Motions  in  a  Random  Seaway  with  SM3DSeakeepRandom3  157 

D. l  Format  of  Input  File  for  SM3DSeakeepRandom3 .  157 

D.2  Sample  Input  File  for  SM3DSeakeepRandom3  .  196 

D. 3  Sample  Output  File  for  SM3DSeakeepRandom3  (Motions 

Only  Given  for  One  Ship  Speed) .  197 

Annex  E:  Files  for  Motions  in  an  Earth-Fixed  Seaway  with 

SM3DSeakeepSeaway3 .  207 

E. l  Format  of  Input  File  for  SM3DSeakeepSeaway3 . 207 

E.2  Sample  Input  File  for  SM3DSeakeepSeaway3 . 234 

E.3  Sample  Output  File  for  SM3DSeakeepSeaway3  (Motions 

Only  Given  for  One  Ship  Speed,  Directional  Seaway  Spectral 
Densities  Removed) .  235 

DRDC  Atlantic  TM  201 1  -308  vii 


Annex  F:  Files  for  Motions  in  an  Earth-Fixed  Seaway  with 

SM3DSeakeepSeawayFromRaos3  .  247 

F.l  Format  of  Input  File  for  SM3DSeakeepSeawayFromRaos3  .  .  247 

F.2  Sample  Input  File  for  SM3DSeakeepSeawayFromRaos3  ....  266 

F. 3  Sample  Output  File  for  SM3DSeakeepSeawayFromRaos3  .  .  .  267 

Annex  G:  Files  for  Producing  Time  Series  of  Ship  Motions  based  on  Response 

Amplitude  Operators .  277 

G. l  Format  of  Input  File  for  SM3DTimeSeriesFromRaos3  ....  277 

G.2  Sample  Input  File  for  SM3DTimeSeriesFromRaos3 . 283 

G.3  Sample  Output  File  for  SM3DTimeSeriesFromRaos3 

(Accelerations  Removed) .  284 


viii 


DRDC  Atlantic  TM  2011-308 


List  of  tables 

Table  1:  Command  Line  Options  for  ShipMo3D  Applications .  6 

Table  2:  SM3DBnildSeaway  Summary .  11 

Table  3:  SM3DFreeMo  Summary  .  15 

Table  4:  SM3DSeakeepRegular  Summary .  16 

Table  5:  SM3DSeakeepRandom  Summary .  17 

Table  6:  SM3D SeakeepSeaway  Summary .  18 

Table  7:  SM3DSeakeepSeawayFromRaos  Summary .  19 

Table  8:  SM3DTimeSeriesFromRaos  Summary .  20 

Table  9:  Representative  Tipping  and  Sliding  Coefficients .  23 

Table  10:  Mil  Risk  Levels .  23 


List  of  figures 


Figure  1:  Earth-Fixed  Coordinate  System .  9 

Figure  2:  Translating  Earth  Coordinate  System .  9 

Figure  3:  Sea  Direction  Relative  to  Ship .  10 

Figure  4:  Long-crested  Seaway  with  Bretschneider  Spectrum,  Sea  State  5  .  .  11 

Figure  5:  Model  for  Person  Standing  on  Deck .  23 

Figure  6:  Assumed  Slamming  Pressure  Distribution  for  Sectional  Force 

Computation  .  24 

Figure  7:  Input  Wedge  Geometry  for  Computing  Slamming  Form  Factor  .  .  26 

Figure  8:  Input  Sectional  Offsets  Near  Keel  for  Computing  Slamming  Form 

Factor .  26 

Figure  9:  Slamming  Pressure  Coefficients  for  Wedge  Sections  .  27 

DRDC  Atlantic  TM  201 1  -308  ix 


This  page  intentionally  left  blank. 


x 


DRDC  Atlantic  TM  2011-308 


1  Introduction 


ShipMo3D  is  an  object-oriented  library  with  associated  applications  for  predicting 
ship  motions.  This  report  describes  applications  for  predicting  ship  motions  in  the 
time  and  frequency  domains.  A  companion  report  [1]  is  the  user  manual  for  creating 
ship  models  required  for  computing  ship  motions.  For  each  ShipMo3D  application, 
user  input  is  read  from  an  ASCII  input  file.  Each  application  produces  an  ASCII 
output  hie,  and  many  applications  also  produce  graphical  output.  The  ShipMo3D 
graphical  user  interface  (GUI),  ShipMo3D30.exe,  can  be  used  to  interactively  prepare 
input  data,  launch  applications,  and  view  output  results. 

Several  reports  describe  the  theory  behind  ShipMo3D,  and  also  give  verification  and 
validation  of  ShipMo3D  results.  References  2  and  3  describe  the  prediction  of  hull  hy¬ 
drodynamic  forces.  The  modelling  of  seaways  is  described  in  Reference  4.  Reference  5 
covers  appendage  and  viscous  forces,  which  are  important  for  predicting  lateral  plane 
motions.  The  extension  of  ShipMo3D  to  freely  maneuvering  ships  is  described  in 
Reference  6,  with  refinements  to  maneuvering  forces  given  in  Reference  7.  ShipMo3D 
Version  3.0  introduces  modelling  of  U-tube  tanks  [8]  and  sloshing  in  tanks  with  free 
surfaces  [9].  Reference  10  gives  validation  results  for  Version  3.0  of  ShipMo3D. 

Section  2  of  this  report  describes  features  that  are  new  for  Version  3  of  ShipMo3D. 
Section  3  gives  an  overview  of  predicting  motions  using  ShipMo3D.  Section  4  de¬ 
scribes  coordinate  systems  used  for  motions  and  ship  geometry.  Section  5  describes 
the  application  SM3DBuildSeaway  for  building  a  model  of  a  seaway.  Time  domain 
motions  in  a  seaway  or  in  calm  water  can  be  computed  using  SM3DFreeMo,  de¬ 
scribed  in  Section  6.  Sections  7,  8,  9  and  10  describe  the  applications  SM3D- 
SeakeepRegular,  SM3DSeakeepRandom,  SM3DSeakeepSeaway,  and  SM3DSeakeep- 
SeawayFromRaos  which  are  used  to  predict  motions  in  the  frequency  domain  for 
various  types  of  sea  conditions.  The  post-processing  program  SM3DTimeSeriesFrom- 
Raos  is  described  in  Section  11.  Section  12  describes  inputs  for  the  rudder  autopilot 
and  Section  13  describes  various  inputs  for  seakeeping  predictions  in  random  seas. 
Final  conclusions  are  given  in  Section  14.  Annexes  at  the  end  of  the  report  give  input 
Hie  descriptions  and  sample  input  and  output  files  for  the  ShipMo3D  applications. 

Detailed  input  formats  and  sampled  files  are  given  in  Annexes  A  to  G.  For  brevity, 
some  portions  of  sample  output  files  have  been  removed  from  this  document;  however, 
full  sample  output  files  are  available  for  the  software. 
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2  New  Features  for  ShipMo3D  Version  3 


ShipMo3D  Version  3  supercedes  Version  2  [11,  12].  Version  3  includes  several  major 
enhancements,  and  also  has  many  minor  code  improvements. 

2.1  High  Frequency  Approximation  for  Evaluating 
Retardation  Functions 

When  computing  wave  radiation  damping  forces  in  the  time  domain,  retardation 
functions  are  used  [3].  The  retardation  functions  are  computed  from  wave  radiation 
damping  coefficients  evaluated  in  the  frequency  domain.  ShipMo3D  Version  3  uses 
the  following  high  frequency  approximation  for  damping  coefficients  when  computing 
retardation  functions  within  SM3DBuildShip: 

Bi:j(uje)  =  Bij(uj*)  exp  (—2u>e/u>l  +  2)  for  ue  >  ui*e  (1) 

where  Bij  is  frequency  domain  damping  for  motion  modes  i  and  j,  uje  is  wave  en¬ 
counter  frequency,  and  cu*  is  the  highest  encounter  frequency  for  damping  coefficients 
used  for  computing  retardation  functions.  The  above  approximation  helps  to  elimi¬ 
nate  oscillatory  behaviour  of  retardation  functions  at  the  maximum  frequency  c o*. 

The  following  high  frequency  approximation  from  Nam  et  al.  [13]  was  originally  con¬ 
sidered  for  implementation  in  ShipMo3D: 

\  2 

for  cue  >  uj*  (2) 

Equation  (1)  provides  faster  decay  of  damping  coefficients  at  higher  frequencies,  and 
appears  to  give  better  modelling  of  actual  behaviour.  Note  that  Equations  (1)  and 
(2)  give  similar  behaviour  of  the  variation  of  damping  coefficients  with  encounter 
frequency  when  encounter  frequency  cue  is  approximately  equal  to  the  maximum  fre¬ 
quency  L U*. 

2.2  Modelling  of  U-tube  Tanks  for  Roll  Stabilization 

ShipMo3D  can  now  model  U-tube  tanks  for  roll  stabilization.  Hydrodynamic  forces 
are  evaluated  using  the  method  of  Lloyd  [14],  with  ShipMo3D  implementation  de¬ 
scribed  in  Reference  8.  Dimensions  for  U-tube  tanks  are  given  as  input  to  SM3D- 
BuildShip. 
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2.3  Modelling  of  Sloshing  in  Tanks  with  Free  Surfaces 

ShipMo3D  can  now  model  sloshing  in  tanks  with  free  surfaces.  Examples  of  such 
tanks  are  cargo  tanks  and  flume  tanks  for  roll  stabilization.  SM3DPanelSloshTank 
builds  a  panelled  representation  of  a  sloshing  tank.  SM3DRadSloshTank  computes 
sloshing  hydrodynamic  forces  in  the  frequency  domain  based  on  the  approaches  of 
Malenica  et  al.  [15]  and  Newman  [16],  with  the  ShipMo3D  implementation  described 
in  Reference  9.  Output  sloshing  tank  data  from  SM3DRadSloshTank  can  be  used  as 
input  to  SM3DBuildShip  when  building  ship  models. 

2.4  Application  SM3DSeakeepSeawayFromRaos  for 
Predicting  Motions  in  a  Seaway  Using  Input 
Response  Amplitude  Operators 

The  new  application  SM3DSeakeepSeawayFromRaos  can  predict  motions  in  the  fre¬ 
quency  domain  for  a  ship  travelling  in  a  seaway  defined  in  earth-fixed  axes.  SM3D- 
SeakeepSeawayFromRaos  reads  pre-computed  motion  response  amplitude  operators 
(RAOs)  which  can  be  computed  by  SM3DSeakeepRandom.  SM3DSeakeepSeaway- 
FromRaos  runs  faster  than  SM3DSeakeepSeaway,  and  is  suitable  for  applications 
such  as  real-time  operator  guidance. 

2.5  Prediction  of  Motion  Sickness  Incidence  in  the 
Frequency  Domain 

When  predicting  ship  motions  in  the  frequency  domain,  the  applications  SM3D- 
SeakeepRandom,  SM3D SeakeepSeaway,  and  SM3DSeakeepSeawayFromRaos  can  now 
predict  motion  sickness  incidence.  Colwell  [17]  describes  the  approaches  used  for 
evaluating  motion  sickness  incidence. 

2.6  Output  of  Motion  Response  Amplitude  Operators 
for  Operability  Analysis  Using  SHIPOP2 

The  frequency  domain  application  SM3DSeakeepRandom  can  now  write  motion  re¬ 
sponse  amplitude  operators  in  SHIPM07  ASCII  post-processing  format,  which  can 
be  used  as  input  for  operability  analysis  using  SHIPOP2  [18]. 
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3  Overview  of  Using  ShipMo3D  for 
Computing  Ship  Motions 


When  computing  ship  motions  in  waves,  the  first  step  is  to  build  a  model  of  a  ship 
that  can  be  used  by  ship  motion  programs.  The  ShipMo3D  manual  for  building  ship 
models  [1]  gives  details  regarding  the  following  applications: 

SM3DPanelHull:  Develops  a  model  of  the  hull  surface  represented  using  trian¬ 
gular  and  quadrilateral  panels.  Also  computes  hydrostatic  properties  for  the 
submerged  portion  of  the  hull. 

SM3DRadDif:  Computes  hydrodynamic  added  mass  and  radiation  damping.  Also 
computes  forces  due  to  incident  and  diffracted  waves. 

SM3DPanelSloshTank:  Develops  a  model  of  the  the  surface  of  a  sloshing  tank 
represented  using  triangular  and  quadrilateral  panels. 

SM3DRadSloshTank:  Computes  sloshing  tank  hydrodynamic  added  mass  and  ra¬ 
diation  damping. 

SM3DBuildShip:  Builds  a  model  of  the  ship  including  all  components  relevant  to 
predicting  ship  motions. 

Once  a  ship  model  has  been  created,  it  can  be  used  for  predicting  motions  in  the  time 
or  frequency  domains.  The  following  programs  are  used  for  predicting  motions  in  the 
time  domain: 

SM3DBuildSeaway:  Builds  a  model  of  a  regular  or  pseudo-random  seaway. 

SM3DFreeShip:  Computes  motions  of  a  freely  maneuvering  ship  in  calm  water  or 
a  seaway. 

The  following  applications  can  be  used  for  frequency  domain  analysis: 

SM3DSeakeepRegular:  Computes  frequency  domain  motions  of  a  ship  in  a  regular 
seaway  (waves  of  constant  heading,  frequency,  and  amplitude). 

SM3DSeakeepRandom:  Computes  frequency  domain  motions  of  a  ship  in  a  ran¬ 
dom  seaway,  with  sea  direction  considered  relative  to  ship  direction.  A  random 
seaway  is  considered  to  have  a  principal  direction,  and  waves  must  be  unidirec¬ 
tional  or  defined  by  a  spreading  function  relative  to  the  principal  wave  direction. 

SM3DSeakeepSeaway:  Computes  frequency  domain  motions  of  a  ship  in  a  ran¬ 
dom  seaway,  with  the  seaway  described  in  earth-fixed  axes  and  ship  heading 
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given  by  absolute  direction  (relative  to  the  ship  heading  north).  A  random  sea¬ 
way  in  earth-fixed  axes  can  be  unidirectional  or  can  have  arbitrary  directional 
spreading. 

SM3DSeakeepSeawayFromRaos:  Computes  frequency  domain  motions  of  a  ship 
in  a  random  seaway  using  previously  computed  RAOs,  with  the  seaway  de¬ 
scribed  in  earth-fixed  axes  and  ship  heading  given  by  absolute  direction  (rel¬ 
ative  to  the  ship  heading  north).  Input  RAOs  are  typically  computed  by 
SM3D  SeakeepRandom . 

SM3DTimeSeriesFromRaos:  Computes  ship  motions  in  the  time  domain  based 
on  response  amplitude  operators  (RAOs)  generated  by  SM3DSeakeepRegular, 
SM3DSeakeepRandom,  or  SM3DSeakeepSeaway. 

SM3DSeakeepRegular  gives  motion  predictions  for  a  ship  in  regular  sinusoidal  waves, 
and  is  most  likely  to  be  used  for  validating  ship  motion  predictions  with  experi¬ 
ments  in  regular  waves.  SM3DSeakeepRandom  gives  motion  predictions  for  a  ship 
in  random  waves  with  a  principal  sea  direction.  Within  SM3DSeakeepRandom,  a 
seaway  spectrum  is  represented  by  a  point  wave  spectrum  and  an  optional  spread¬ 
ing  angle  applied  to  a  cosine-squared  spreading  function.  Input,  output,  and  com¬ 
putations  with  SM3DSeakeepRandom  consider  the  principal  sea  direction  relative 
to  the  ship  heading  (180  degrees  for  head  seas,  90  degrees  for  seas  from  port). 
SM3DSeakeepRandom  is  most  likely  to  be  used  for  general  seakeeping  and  oper¬ 
ability  analysis.  SM3DSeakeepSeaway  gives  motion  predictions  for  a  ship  in  a  seaway 
described  by  a  wave  spectrum  with  a  fixed  orientation,  such  as  a  multi-directional 
wave  spectrum  that  has  been  measured  using  a  wave  buoy  or  wave  radar  system.  In¬ 
put,  output,  and  computations  with  SM3DSeakeepSeaway  consider  ship  heading  (0 
degrees  for  the  ship  heading  north) .  SM3DSeakeepSeaway  is  most  likely  to  be  used  for 
comparing  predictions  with  full-scale  trials  and  for  real-time  operator  guidance  sys¬ 
tems.  SM3DSeakeepSeawayFromRaos  gives  output  similar  to  SM3DSeakeepSeaway, 
but  has  faster  execution  because  it  uses  pre-computed  RAOs. 

Frequency  domain  motion  predictions  are  essentially  linear;  however,  the  nonlinear  in¬ 
fluence  of  roll  motion  amplitude  on  roll  damping  is  modelled.  ShipMo3D  roll  damping 
computations  are  described  in  detail  in  Reference  5.  For  SM3DSeakeepRegular,  roll 
amplitude  and  associated  roll  damping  are  evaluated  iteratively  for  each  combination 
of  ship  speed,  heading,  wave  frequency,  and  wave  amplitude.  For  SM3DSeakeep- 
Random,  RMS  roll  motion  and  associated  roll  damping  are  evaluated  iteratively  in 
long-crested  seas  for  each  combination  of  wave  spectrum,  ship  speed,  and  heading. 
The  following  relationship  is  used  for  determining  effective  roll  amplitude  and  asso¬ 
ciated  roll  damping  in  random  seas: 

M  =  1.25  <7(774)  (3) 
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where  |t74|  is  the  roll  amplitude  used  for  roll  damping  computations  and  <7(774)  is 
the  RMS  roll  motion.  For  SM3DSeakeepSeaway,  RMS  roll  motion  and  associated 
roll  damping  are  evaluated  iteratively  with  the  specified  wave  spectrum  for  each 
combination  of  ship  speed  and  absolute  ship  heading.  Unlike  SM3DSeakeepRandom, 
SM3D SeakeepSeaway  considers  the  influence  of  short-crested  waves  when  determining 
roll  response  amplitude  operators  (RAOs);  however,  roll  RAOs  from  SM3DSeakeep- 
Seaway  can  only  be  considered  valid  for  the  specific  combination  of  earth-fixed  wave 
spectrum,  ship  speed,  and  absolute  ship  heading. 

Predicted  ship  motion  RAOs  from  SM3DSeakeepRegular,  SM3DSeakeepRandom,  or 
SM3DSeakeepSeaway  can  be  used  for  generating  time  series  of  ship  motions  with 
SM3DTimeSeriesFromRaos.  Alternatively,  time  series  of  ship  motion  can  be  gener¬ 
ated  directly  using  SM3DFreeMo. 

ShipMo3D  applications  use  4  main  types  of  hies.  User  input  data  are  read  from  input 
hies  with  names  ending  with  “.inp”.  Application  output  data  for  review  by  the  user 
are  written  to  output  hies  with  names  ending  with  “.out”.  Transfer  of  data  between 
applications  is  done  mostly  using  hies  in  .NET  binary  format,  with  names  ending 
with  “.bin”.  Transfer  of  seaway  data  between  applications  is  done  using  hies  in  .NET 
XML  format,  with  names  ending  with  “.xml”.  The  usage  of  XML  format  for  seaway 
data  facilitates  usage  of  seaway  data  by  external  applications,  such  as  visualizers. 

Each  ShipMo3D  application  has  default  hie  names  for  input  and  output.  Prehxes  can 
be  added  to  default  hie  names  by  typing  “-p  PREFIX”  as  a  command  line  option, 
where  PREFIX  is  the  specihed  hie  name  prehx  (e.g.,  the  ship  name).  Alternatively, 
full  input  and  output  hie  names  can  be  specifed  on  the  command  line.  Input  hie 
names  can  be  specihed  by  typing  “-i  INFILE”  as  a  command  line  option,  where 
INFILE  is  the  specihed  input  hie  name.  Similarly,  output  hie  names  can  be  specihed 
by  typing  “-o  OLITFILE”  as  a  command  line  option,  where  OUTFILE  is  the  specihed 
output  hie  name.  The  command  line  option  “-h”  shows  any  command  line  arguments 
associated  with  a  ShipMo3D  application.  The  command  line  option  “-e”  specihes  that 
exceptions  that  occur  during  program  execution  should  be  fully  written  to  the  console. 
Table  1  summarizes  command  line  options. 


Table  1:  Command  Line  Options  for  SliipMo3D  Applications 


-e 


-p  PREFIX 
-i  INFILE 
-o  OUTFILE 
-h 


Input  and  output  hie  names  have  prehx  PREFIX 

Input  hie  name  is  INFILE 

Output  hie  name  is  OUTFILE 

Help  is  written  to  output  console 

Execution  exceptions  are  written  to  console 
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ShipMo3D  user  input  files  are  in  ASCII  format.  Each  input  line  typically  begins  with 
a  tag  denoting  the  contents  of  the  input  line.  Comments  can  be  inserted  into  a  hie 
using  the  character  “7^”  to  denote  a  comment  line  or  the  beginning  of  a  comment 
after  other  input  on  a  line.  An  exclamation  mark  “!”  denotes  that  an  input  line  is 
continued  on  the  next  line.  Here  is  some  sample  input  demonstrating  the  usage  of 
the  comment  and  continuation  characters: 


#  Sample  input  from  a  SM3DSeakeepRegular  input  file. 
seaDirsDeg  0.0  15.0  30.0  45.0  60.0  75.0  90.0  105.0  ! 
120.0  135.0  150.0  165.0  180.0 


The  ShipMo3D  graphical  user  interface  (GUI),  application  ShipMo3D30.exe,  can  be 
used  for  running  all  ShipMo3D  applications.  The  GUI  program  assists  with  input 
data  preparation  and  interactive  viewing  of  results. 
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4  Coordinate  Systems 


ShipMo3D  uses  both  earth-fixed  and  translating  earth  coordinate  systems.  Figure  1 
shows  a  ship  in  an  earth-fixed  coordinate  system.  The  location  of  the  ship  centre  of 
gravity  in  the  horizontal  plane  is  given  by  x\y* .  The  direction  v  of  incident  waves 
is  given  using  a  “from”  convention,  with  0°  representing  waves  from  north  and  90° 
representing  waves  from  east.  Ship  heading  x  is  given  using  a  “to”  convention,  with 
0°  representing  the  ship  heading  north  and  90°  representing  the  ship  heading  east. 

A  translating  earth  coordinate  system,  shown  in  Figure  2,  is  used  for  representing 
ship  motions  in  heave,  roll,  and  pitch,  and  also  for  frequency  domain  applications. 
Heave  rj 3  is  the  vertical  displacement  (+  upward)  of  the  ship  centre  of  gravity  relative 
to  its  position  when  the  ship  is  in  calm  water;  thus,  the  mean  heave  is  typically  near 
zero.  Ship  pitch  rj 5  of  a  freely  maneuvering  ship  is  given  relative  to  its  position  at 
heading  y,  and  ship  roll  rj 4  is  given  relative  to  the  instantaneous  heading  angle  x  and 
pitch  angle  ij 5  of  the  moving  ship. 

Wave  diffraction  computations  using  SM3DRadDif  and  seakeeping  computations  us¬ 
ing  SM3DSeakeepRegnlar  and  SM3DSeakeepRandom  are  based  on  relative  sea  direc¬ 
tion  f3s  as  shown  in  Figure  3  (180°  for  head  seas,  90°  for  seas  from  port).  Relative 
sea  direction  is  related  to  ship  heading  and  wave  heading  by: 

Ps  =  V  +  180°  -  X  (4) 


For  deflections  of  rudders,  ShipMo3D  uses  a  convention  of  positive  deflection  when 
counter-clockwise  as  viewed  from  inside  the  hull.  Consequently,  positive  deflection  of 
a  typical  ship  rudder  pointing  downward  will  cause  a  ship  to  turn  starboard. 
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Ship 


Figure  1:  Earth-Fixed  Coordinate  System 


Figure  2:  Translating  Earth  Coordinate  System 
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Figure  3:  Sea  Direction  Relative  to  Ship 
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5  Building  of  Seaway  Model  - 
SM3DBuildSeaway 


Table  2  gives  a  summary  of  application  SM3DBuildSeaway,  which  creates  a  regular 
or  random  seaway  in  earth- fixed  coordinates.  Figure  4  shows  a  sample  view  of  a 
long-crested  random  seaway  produced  by  SM3DBuildSeaway. 


Table  2:  SM3DBuildSeaway  Summary 


Purpose: 

Run  time: 

Default  input  file: 

Default  output  file: 

Input  format  and  sample  hies: 


Creates  a  regular  or  random  seaway  in 
fixed-earth  coordinates. 

Several  seconds. 
buildSeaway3.inp 
buildSeaway3.out 
Annex  A 


Figure  4:  Long-crested  Seaway  with  Bretschneider  Spectrum,  Sea  State  5 

SM3DBuildSeaway  represents  random  seaways  using  superposition  of  a  number  of 
sinusoidal  wave  components.  Both  unidirectional  and  multidirectional  random  sea¬ 
ways  can  be  produced.  For  a  random  seaway,  the  range  of  wave  frequencies  should 
be  sufficient  to  encompass  almost  all  energy  within  the  wave  spectrum.  For  ocean 
wave  spectra,  a  frequency  range  of  0.2  -  2.0  rad/s  is  recommended. 

5.1  Wave  Spectra  for  Random  Seaways 

SM3DBuildSeaway  can  produce  random  seaways  based  on  input  wave  spectra.  Refer¬ 
ence  4  describes  modelling  of  seaways  in  detail.  Wave  spectra  available  in  SM3DBuild- 
Seaway  are  provided  here  for  reference.  For  point  wave  spectra  (i.e. ,  non-directional 
spectra),  ShipMo3D  uses  units  of  m2/(rad/s)  for  spectral  density.  For  directional 
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wave  spectra,  ShipMo3D  uses  units  of  m2/ (rad/s) /deg  for  directional  spectral  den¬ 
sity. 


5.1.1  Bretschneider  Spectrum 


The  Bretschneider  spectrum  is  the  most  commonly  used  model  of  point  wave  spectra 
in  the  open  ocean.  Based  on  the  15th  International  Towing  Tank  Conference  (ITTC) 
[19],  the  formulation  for  the  Bretschneider  spectrum  is: 


SUl(u;i) 


486.0  H2S 


exp 


—  1948.2’ 


(5) 


where  Ui  is  wave  frequency,  and  Hs  is  significant  wave  height.  The  above  spectrum  is 
defined  in  terms  of  peak  wave  period  Tp.  For  a  Bretschneider  spectrum,  the  following 
relations  exist  with  the  average  and  zero-crossing  wave  periods: 


7i  =  0.773  Tp  (6) 

Tz  =  0.710  Tp  (7) 


5.1.2  Three  Parameter  JONSWAP  Spectrum 


The  JONSWAP  spectrum  models  relatively  high-peaked  point  spectra  typically  en¬ 
countered  in  fetch-limited  regions  [19].  The  JONSWAP  spectrum  is  obtained  by 
multiplying  the  Bretschneider  spectrum  by  a  peak  enhancement  factor  accounting 
for  fetch-limited  conditions,  giving  the  following  [20]: 


SUl(ui) 


K 


a 


LU, 


LU 


p 

|  exp 


out 

'1.25— j 


LU' 


'/  J 


■  (U!  -  (Up)2 

2a2ou2 
for  luj  < 


7 


(8) 

(9) 

(10) 


where  lup  is  the  peak  wave  frequency  and  7  is  an  input  spectral  peak  parameter.  Goda 
[21]  derived  the  following  approximate  expression  for  the  normalization  term  a*: 


0.0624 

0.230  +  0.0336  7  -  0.185/(1.9  +  7) 


(11) 


The  JONSWAP  spectrum  is  often  presented  as  a  two  parameter  spectrum,  with  the 
spectral  peak  parameter  7  having  a  default  value  of  3.3. 


12 


DRDC  Atlantic  TM  2011-308 


5.1.3  Ochi  and  Hubble  Six  Parameter  Spectrum 


The  Ochi  and  Hubble  6  parameter  point  spectrum  [22]  models  collinear  swell  and  sea 
components  as  follows: 


SUI{u)!) 


i=l 


r(A i)  co 


(4Aj+l) 

I 


(12) 


where  A*,  hs-i,  and  c op-i  are  the  spectral  shape  parameter,  significant  wave  height, 
and  peak  frequency  for  component  i.  The  term  T(Aj)  is  the  Gamma  function  with 
argument  A,;.  If  only  one  of  the  two  components  is  considered  and  the  shape  parameter 
A i  equals  one,  then  the  six  parameter  spectrum  is  equivalent  to  the  Bretschneider 
spectrum. 


5.1 .4  Bretschneider  and  JONSWAP  Spectrum  with 
Cosine-Squared  Spreading  Function 

A  directional  wave  spectrum  can  be  most  easily  modelled  by  multiplying  a  point 
spectrum  by  a  directional  spreading  function  as  follows: 

SUl,v(U}i>1')  =  G(u)  (13) 

where  G(v)  is  a  directional  spreading  function.  ShipMo3D  can  apply  a  cosine-squared 
spreading  function  to  a  Bretschneider  or  JONSWAP  spectrum.  The  form  of  the 
spreading  function  is  as  follows: 

G(u)  =  j  cos2  (j  Q  ^  ^  \v  -  V\  <  9S  (14) 

G(v)  =  0  for  \u  —  V\>  9S  (15) 

where  V  is  the  principal  wave  direction  and  9S  is  the  spreading  angle  in  degrees. 
A  spreading  angle  of  90  degrees  is  often  used  for  seakeeping  computations.  The 
spreading  function  given  in  Equation  (14)  has  units  of  deg-1  when  the  terms  u,  u, 
and  9S  are  given  in  units  of  degrees.  Although  Equations  (14)  and  (15)  are  defined 
using  directions  v  and  V  based  in  fixed-earth  axes,  they  can  also  be  easily  defined  in 
terms  of  relative  sea  direction  /3S. 

5.1.5  Ten  Parameter  Directional  Spectrum 

Directional  seas  can  be  most  apparent  when  sea  and  swell  components  are  similar  in 
magnitude  and  are  approaching  from  different  directions.  The  ten  parameter  spec¬ 
trum  developed  by  Hogben  and  Cobb  [23]  is  a  directional  extension  of  the  Ochi  and 
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Hubble  six  parameter  spectrum,  with  each  of  the  swell  and  sea  components  being 
multiplied  by  its  own  directional  spreading  function  as  follows: 


Mi(  v) 


A(Pi )  cos2Pi 


for  i 


1,2 


(16) 


where  Pj  and  vt  are  the  directional  spreading  parameter  and  mean  direction  (from) 
for  component  i.  The  normalization  factor  H(Pj)  is  expressed  as: 


m) 


2(2Pi-i)  r 2(Pi  + 1) 
180°  T(2Pj  + 1) 


i  =  1,2 


(17) 


where  T(2Pj  + 1)  is  the  Gamma  function  with  argument  2 Pj  + 1.  The  above  equations 
are  based  on  parameters  v  and  ip  being  in  units  of  degrees,  and  each  spreading 
function  Mi(u )  having  units  of  degrees”1. 
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6  Motions  of  Freely  Maneuvering  Ship  in  a 
Seaway  -  SM3DFreeMo 


Tabic  3  gives  a  summary  of  application  SM3DFreeMo  for  simulating  motions  in  the 
time  domain  of  a  freely  maneuvering  ship. 


Purpose: 

Table  3:  SM3DFreeMo  Summary 

Simulates  motions  in  the  time  domain  of  a  freely 
maneuvering  ship. 

Run  time: 

Default  input  hie: 
Default  output  hie: 

Typically  faster  than  real-time. 
freeMo3.inp 

freeMo3.out 

Input  format  and  sample  hies:  Annex  B 

Other  required  input:  A  ship  model  hie  created  by  SM3DBuildShip  [1] 

A  seaway  model  hie  created  by 
SM3DBuildSeaway  if  the  ship  is  in  waves. 
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7  Ship  Seakeeping  in  a  Regular  Seaway  - 
SM3DSeakeepRegular 


Tabic  4  gives  a  summary  of  application  SM3DSeakeepRegular. 

Table  4:  SM3DSeakeepRegular  Summary 


Purpose: 

Run  time: 

Default  input  file: 

Default  output  file: 

Input  format  and  sample  files: 
Other  required  input: 


Computes  ship  motions  in  the  frequency  domain 
for  a  ship  in  regular  waves. 

A  few  seconds, 
seakeep  Regular  3 .  inp 
seakeepRegular3 .  out 
Annex  C 

A  ship  model  hie  created  by  SM3DBuildShip  [1], 
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8  Ship  Seakeeping  in  a  Random  Seaway  with 
Principal  Direction  Given  Relative  to  the 
Ship  -  SM3DSeakeepRandom 


Tabic  5  gives  a  summary  of  application  SM3DSeakeepRandom. 

Table  5:  SM3DSeakeepRandom  Summary 


Purpose: 


Run  time: 

Default  input  file: 

Default  output  file: 

Input  format  and  sample  files: 
Other  required  input: 


Computes  ship  motions  in  the  frequency  domain 
for  a  ship  in  random  waves  with  a  principal  sea 
direction  (i.e. ,  long-crested  waves  or  waves  with  a 
cosine-squared  spreading  function). 

A  few  seconds. 
seakeepRandom3.  inp 
seakeepRandom3 .  out 
Annex  D 

A  ship  model  hie  created  by  SM3DBuildShip  [1], 
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9  Ship  Seakeeping  in  a  Fixed  Seaway  with 
Ship  Heading  Given  Relative  to 
Earth-Fixed  Axes  -  SM3DSeakeepSeaway 


Tabic  6  gives  a  summary  of  application  SM3DSeakeepSeaway. 

Table  6:  SM3DSeakeepSeaway  Summary 


Purpose: 


Run  time: 

Default  input  file: 

Default  output  file: 

Input  format  and  sample  files: 
Other  required  input: 


Computes  ship  motions  in  the  frequency  domain 

for  a  ship  in  an  earth-fixed  seaway,  with  ship 

heading  given  relative  to  earth-fixed  axes. 

Ranging  from  a  few  seconds  to  several  minutes. 

seakeepSeaway3.inp 

seakeep  Seaway  3 .  out 

Annex  E 

A  ship  model  hie  created  by  SM3DBuildShip  [1], 


18 


DRDC  Atlantic  TM  2011-308 


10  Ship  Seakeeping  in  a  Fixed  Seaway  Using 
Previously  Computed  Ship  Motion  RAOs 
-  SM3DSeakeepSeawayFromRaos 


Table  7  gives  a  summary  of  application  SM3DSeakeepSeawayFromRaos. 

Table  7:  SM3DSeakeepSeawayFromRaos  Summary 


Purpose: 

Computes  ship  motions  in  the  frequency  domain 
for  a  ship  in  an  earth-fixed  seaway,  with  ship 
heading  given  relative  to  earth-fixed  axes. 
Previously  computed  ship  motion  response 
amplitude  operators  are  used,  giving  fast 
execution. 

Run  time: 

Default  input  file: 

Default  output  file: 

Input  format  and  sample  files: 
Other  required  input: 

A  few  seconds. 

seakeepSeaway  FromRaos3 .  inp 
seakeepSeaway  FromRaos3.  out 

Annex  F 

A  database  of  ship  RAOs  created  by 
SM3DSeakeepRegular,  SM3DSeakeepRandom,  or 
SM3DSeakeepSeaway. 
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1 1  Time  Series  of  Ship  Motions  from 
Response  Amplitude  Operators  - 
SM3DTimeSeriesFromRaos 


Tabic  8  gives  a  summary  of  application  SM3DTimeSeriesFromRaos. 

Table  8:  SM3DTimeSeriesFromRaos  Summary 


Purpose: 

Run  time: 

Default  input  file: 

Default  output  file: 

Input  format  and  sample  files: 
Other  required  input: 


Computes  ship  motions  in  the  time  domain  for  a 

ship  with  quasi-steady  speed  and  heading 

A  few  seconds. 

timeSeriesFromRaos3.inp 

timeSeriesFromRaos3.out 

Annex  G 

A  database  of  ship  RAOs  created  by 
SM3DSeakeepRegular,  SM3DSeakeepRandom,  or 
SM3DSeakeepSeaway. 

A  seaway  model  created  by  SM3DBuildSeaway. 
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12  Inputs  for  Rudder  and  Azimuthing 
Propeller  Autopilots 


For  the  motion  prediction  applications  SM3DFreeMo,  SM3DSeakeepRegnlar,  SM3D- 
SeakeepRandom,  and  SM3DSeakeepSeaway,  the  user  can  specify  input  autopilot  set¬ 
tings.  If  autopilot  settings  are  not  given  as  input  for  these  applications,  then  default 
settings  are  used  from  the  ship  model  produced  by  SM3DBuildShip  [1], 


For  time  domain  simulation,  ShipMo3D  models  a  proportional-integral-derivative 
(PID)  autopilot.  If  the  rudder  is  operating  in  autopilot  mode,  then  the  rudder  com¬ 
mand  angle  is  determined  by  input  autopilot  gains  and  ship  motions  in  earth-fixed 
axes: 


zrudder 

°C 


(18) 


where  is  the  proportional  gain  for  mode  j,  is  the  motion  displacement  in  earth- 
fixed  axes  for  mode  j,  is  the  command  motion  displacement  for  mode  j,  kr6j  is 
the  integral  gain  for  mode  j ,  T™lfer  is  the  integration  duration,  t  is  the  current  time, 
r  is  the  time  delay  for  integration,  kfj  is  the  derivative  gain  for  mode  j,  and  is  the 
motion  velocity  in  earth- fixed  axes  for  mode  j.  For  frequency  domain  computations, 
the  integral  gains  k^  are  assumed  to  be  zero. 

For  all  ShipMo3D  user  applications,  user  input  autopilot  gains  are  based  on  earth- 
fixed  coordinates;  thus,  input  yaw  gains  are  based  on  yaw  being  positive  clockwise 
when  viewed  from  above.  For  modelling  of  a  conventional  downward  rudder  using 
ShipMo3D,  the  input  yaw  displacement  gain  and  yaw  velocity  gain  will  typically  have 
values  equal  to  or  less  than  zero.  Note  that  input  surge  and  sway  gains  should  be  set 
to  zero. 


DRDC  Atlantic  TM  2011-308 


21 


13  Inputs  for  Frequency  Domain  Ship  Motion 
Predictions  in  Random  Seas 


This  section  gives  background  information  that  is  useful  when  running  the  applica¬ 
tions  SM3DSeakeepRandom,  SM3DSeakeepSeaway,  and  SM3DSeakeepSeawayFrom- 
Raos  for  predicting  motions  in  random  seas. 

13.1  Wave  Spectra 

Section  5  of  this  report,  which  describes  input  for  SMB3DBuildSeaway,  provides 
useful  information  on  wave  spectra  that  can  be  used  as  input  for  frequency  domain 
predictions. 

13.2  Motion-Induced  Interruptions 

The  frequency  domain  applications  SM3DSeakeepRandom,  SM3DSeakeepSeaway  and 
SM3DSeakeepSeawayFromRaos  can  compute  ship-referenced  forces  and  estimate  the 
incidence  of  motion-induced  interruptions  (Mils)  at  seakeeping  positions.  The  inci¬ 
dence  of  Mils,  which  can  be  tipping  or  sliding  events,  is  estimated  using  tipping  or 
sliding  estimator  functions  which  include  the  contributions  of  vertical  forces  as  well 
as  the  forces  parallel  to  the  deck.  Detailed  treatment  of  Mils  is  given  in  References 
24  and  25. 

The  incidence  of  tipping  events  for  a  person  or  object  depends  upon  the  tipping 
coefficient  s/h,  where  s  is  the  half  stance  width  and  h  is  the  height  above  deck  of  the 
centre  of  gravity,  as  shown  in  Figure  5.  The  tipping  coefficient  is  usually  dependent 
upon  the  direction  of  tipping.  To  evaluate  the  incidence  of  sliding  events,  the  tipping 
coefficient  s/h  can  be  replaced  by  the  static  coefficient  of  friction  fis.  Table  9  gives 
representative  tipping  and  sliding  coefficients  from  Reference  25  and  unpublished 
data.  The  wide  range  of  friction  coefficients  suggests  the  incidence  of  sliding  can 
vary  greatly,  depending  on  sliding  surface  conditions.  Because  the  static  coefficient 
of  friction  for  a  person  is  usually  greater  than  the  tipping  coefficient,  a  person  will 
usually  tip  more  easily  than  slide.  Table  10,  reproduced  from  Reference  24,  gives  risk 
levels  associated  with  motion-induced  interruptions  (Mils). 

13.3  Slamming  Pressures  and  Forces 

Slamming  calculations  within  ShipMo3D  are  based  largely  on  the  work  of  Ochi  and 
Motter  [26]  and  Stavovy  and  Chuang  [27].  The  maximum  slam  pressure  at  the  keel 
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Figure  5:  Model  for  Person  Standing  on  Deck 


Table  9:  Representative  Tipping  and  Sliding  Coefficients 


Tipping  in  the  forward  direction  0.17 

Tipping  in  the  sideways  direction  0.25 

Sliding,  person  standing  on  dry  deck  0.7 

Sliding,  chair  on  interior  floor  0.19 

Sliding,  helicopter  for  various  deck  conditions  0.2  -  0.8 


Table  10:  Mil  Risk  Levels 


Risk  Level 

Mils  per  Minute 

1.  possible 

0.1 

2.  probable 

0.5 

3.  serious 

1.5 

4.  severe 

3.0 

5.  extreme 

5.0 
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is  related  to  a  sectional  slamming  pressure  coefficient  as  follows: 


Pmax 


1 

2 


p  Vx  x  slamPressureCo 


(19) 


where  p  is  water  density,  VT  is  the  relative  impact  velocity  upon  impact,  and  slam¬ 
PressureCo  is  the  slamming  pressure  coefficient,  which  can  be  given  as  an  input 
parameter  or  computed  based  on  input  geometry.  For  calculating  the  slamming  force 
per  unit  length,  ShipMo3D  uses  the  assumption  from  Reference  26  that  the  sectional 
slamming  pressure  goes  from  a  maximum  value  at  the  keel  to  zero  at  a  specified  ele¬ 
vation  above  the  keel,  as  illustrated  in  Figure  6.  The  elevation  of  zero  slam  pressure 
is  typically  taken  as  being  Tx/ 10  above  the  keel,  where  Tx  is  the  sectional  draft.  The 
sectional  slamming  force  per  unit  length  is  computed  using  an  effective  slamming 
pressure  width  as  follows: 


Fmax  =  Pmax  x  slauiForceWidth 


(20) 


where  slamForceWidth  is  given  as  an  input  parameter  or  computed  based  on  sectional 
geometry. 


Pressured  distribution 


Figure  6:  Assumed  Slamming  Pressure  Distribution  for  Sectional  Force  Computation 

The  user  can  provide  input  values  for  the  slamming  pressure  coefficient  and  effec¬ 
tive  force  width.  Alternatively,  ShipMo3D  can  compute  the  pressure  coefficient  and 
effective  width  based  on  the  lower  sectional  geometry  provided  by  the  user.  If  the 
geometry  is  input  as  a  wedge  as  shown  in  Figure  7,  then  ShipMo3D  uses  a  fit  to  exper¬ 
imental  data  given  by  Stavovy  and  Chuang  for  computing  the  form  factor.  Stavovy 
and  Chuang’s  method  has  been  slightly  modified  to  impose  a  form  factor  limit  of  100, 
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which  affects  sections  with  deadrise  angles  smaller  than  6  degrees.  Using  the  assumed 
pressure  distribution  of  Figure  6,  the  effective  pressure  width  for  a  wedge  is: 


,  TTr.  slamForceHeight 

slamhorceWidth  =  - - 

tan(deadRiseDeg) 


(21) 


where  slamForceHeight  is  the  height  above  the  keel  at  which  the  slamming  pressure 
goes  to  zero  and  deadRiseDeg  is  the  deadrise  angle. 


If  the  user  inputs  the  geometry  near  the  keel  as  offsets,  then  ShipMo3D  uses  Ochi  and 
Motter’s  method  to  compute  slamming  form  coefficients.  Figure  8  illustrates  input 
offsets  for  computing  the  slamming  form  factor. 


Experimental  results  indicate  that  slamming  pressures  can  be  highly  sensitive  to  ship 
section  geometry,  size  of  area  of  pressure  measurement,  and  structural  properties  of 
impact  area;  thus,  predicted  slamming  pressures  and  forces  should  be  considered  to 
be  only  approximate  values.  Published  values  indicate  that  slamming  form  factors 
can  he  within  an  extremely  large  range  of  between  less  than  1  and  greater  than  300; 
however,  the  actual  slamming  coefficient  for  a  ship  section  in  a  seaway  will  rarely 
exceed  30.  Slamming  coefficients  computed  using  input  offsets  near  the  keel  and 
Ochi  and  Motter’s  method  are  likely  smaller  in  magnitude  and  more  realistic  than 
values  computed  for  a  wedge  based  on  Stavovy  and  Chuang.  Figure  9  shows  slamming 
coefficients  predicted  by  ShipMo3D  for  wedge  sections  based  on  Stavovy  and  Chuang’s 
method  and  Ochi  and  Motter’s  method.  For  wedge  sections  with  large  deadrise  angles 
(greater  than  50  degrees),  Ochi’s  method  fails  to  provide  results  because  of  numerical 
problems. 
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Upper  limit  of  slamming  pressure 


slamForceHeight 


deadRiseDeg 


- ^ 

Figure  7:  Input  Wedge  Geometry  for  Computing  Slamming  Form  Factor 


Figure  8:  Input  Sectional  Offsets  Near  Keel  for  Computing  Slamming  Form  Factor 
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Pressure  coefficient  slamPressureCo 


Figure  9:  Slamming  Pressure  Coefficients  for  Wedge  Sections 
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14  Conclusions 


ShipMo3D  Version  3.0  includes  applications  for  predicting  ship  motions  in  the  time 
and  frequency  domains.  A  separate  user  manual  [1]  describes  development  of  ship 
models  for  input  into  ship  motion  predictions. 
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Symbols  and  Abbreviations 


m) 

F 

1  max 

G(v) 

Hs 

h 

hs—i 

kZ 

kh 

Mil 

Mt(y) 

Pi 

Pmax 

RAO 

RMS 

sUI  M 

SUI,v(u}i,v) 

s 

Tp 

Tx 

Tz 

T\ 

Vr 

xf,yf 

a* 

Ps 

rpO 

7 

£ rudder 

Cs 

Vj 

Vcj 


normalization  factor  for  ten  parameter  spectral  component  i 

maximum  slamming  force 

directional  wave  spectral  spreading  function 

significant  wave  height 

height  above  deck  of  the  person  or  object  centre  of  gravity 
significant  wave  height  for  spectral  component  i 
autopilot  derivative  (velocity)  gain  for  mode  j 
autopilot  integral  gain  for  mode  j 
autopilot  proportional  (displacement)  gain  for  mode  j 
motion- induced  interruption 

spreading  function  for  ten  parameter  spectrum  component  i 

spreading  parameter  for  ten  parameter  spectrum  component  % 

maximum  slamming  pressure 

response  amplitude  operator 

root  mean  square 

point  wave  spectral  density 

directional  wave  spectral  density 

half  stance  width  for  computing  Mils 

peak  wave  period 

sectional  draft 

zero-crossing  period 

average  wave  period 

relative  vertical  velocity 

horizontal  plane  coordinates  in  earth-fixed  axes 
JONSWAP  spectrum  normalization  term 
sea  direction  relative  to  ship 
Gamma  function  with  argument  X 
spectral  peak  enhancement  parameter 
rudder  deflection  angle 

rudder  nondimensional  damping  response  constant 
displacement  in  translating  earth  axes  for  mode  j 
displacement  in  earth-fixed  axes  for  mode  j 
command  displacement  in  earth-fixed  axes  for  mode  j 
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9S  spreading  angle  for  cosine  squared  spectral  spreading 

k  JONSWAP  spectrum  exponent 

A i  spectral  shape  parameter  for  spectral  component  i 

fxs  static  coefficient  of  friction 

v  wave  direction  (from)  in  earth-fixed  axes 

V  mean  wave  direction  (from)  in  earth-fixed  axes 

v i  mean  wave  direction  (from)  for  spectral  component  i 

p  water  density 

a  standard  deviation  (also  RMS)  or  JONSWAP  spectrum  parameter 

Tmaxer  rudder  autopilot  integration  duration 

X  ship  heading  (to)  in  earth-fixed  axes 

u>i  incident  wave  frequency 

Up  peak  wave  frequency 

peak  wave  frequency  for  spectral  component  i 
ojs  rudder  response  natural  frequency 
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Annex  A:  Files  for  Building  a  Seaway  with 
SM3DBuildSeaway3 


A.1  Format  of  Input  Seaway  File  for 
S  M3  D  B  u  i  I  d  Sea  way  3 

Record  (1),  Beginning  Record 

“begin  SM3DBuildSeaway3”  (1  character  string  with  2  words) 

Record  (2),  Run  Label 

“label” ,  label  (2  character  strings) 

“label”  Record  tag. 

label  Label  for  run.  This  can  include  spaces. 

Record  (3),  Beginning  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

“begin  note”  (1  character  string  with  2  words) 

Record  (3a),  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

noteText  (character  string) 

noteText  Text  of  note.  Multiple  lines  can  be  entered. 

Record  (3b),  End  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

“end  note”  (1  character  string  with  2  words) 


DRDC  Atlantic  TM  2011-308 


35 


Record  (4),  Output  Seaway  File  Name 

“seawayFilcName”,  seawayFileName  (2  character  strings) 

“seawayFileName”  Record  tag. 

seawayFileName  Name  of  output  seaway  file  in  .NET  XML  serialization 
format. 

Record  (5),  Water  Density 

“waterDensity” ,  waterDensity  (1  character  string,  1  float) 

“waterDensity”  Record  tag. 
waterDensity  Water  density  (kg/m3). 

Record  (6),  Time  Series  Sampling  Parameters 

This  record  is  optional.  If  this  record  is  omitted  then  default  values  are  used. 
“sampleParams”,  tDuration,  tlnterval  (1  character  string,  2  floats) 
“sampleParams”  Record  tag. 

tDuration  Duration  of  seaway  for  sample  statistics  (default  3600.0  s). 

tlnterval  Time  interval  for  sample  statistics  (default  0.1  s). 
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Record  (7),  Seaway  Option 

“seawayOption” ,  seawayOption  (2  character  strings) 

“seawayOption”  Record  tag. 
seawayOption  Seaway  option. 

Regular  -  Regular  waves. 

UniSpectrum  -  Unidirectional  seaway  based  on  input  spectrum. 

BiSpectrum  -  Bidirectional  seaway  based  on  2  unidirectional 
input  spectra. 

CosSpectrum  -  Directional  seaway  based  on  a  point  spectrum 
and  a  cosine-squared  directional  spreading  function. 

DirSpectrum  -  Directional  seaway  based  on  input  spectrum. 

ComponentRandom  -  Seaway  consisting  of  multiple  input  wave 
components,  most  commonly  used  to  represent  a  random 
seaway.  Wave  component  phases  are  randomly  generated. 

ComponentPhase  -  Seaway  consisting  of  multiple  input  wave 
components,  including  wave  component  phases. 

Record  (8),  Beginning  of  Regular  Seaway 

Records  (8)  to  (8c)  are  required  if  seawayOption  is  set  to  Regular  in  Record  (7). 
“begin  regularSeaway”  (1  character  string  with  2  words) 


Record  (8a),  Regular  Seaway  Parameters 

This  record  is  required  if  seawayOption  in  Record  (7)  is  set  to  Regular. 

“regularParam” ,  waveHeadingDeg,  waveFreq,  waveAmp,  phaseDeg,  (1  character 
string,  4  floats) 

“regularParam”  Record  tag. 

waveHeadingDeg  Wave  direction  (from,  degrees).  0°  for  waves  from  north,  and 
90°  for  waves  from  east. 


waveFreq 

waveAmp 

phaseDeg 


Incident  wave  frequency  (rad/s). 

Incident  wave  amplitude  (m). 

Phase  of  wave  crest  at  xJ  =  0.0,  yf  =  0.0  (degrees). 
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Record  (8b),  Regular  Seaway  Nonlinear  Option 

This  record  can  optionally  be  used  if  seawayOption  in  Record  (7)  is  set  to 
Regular.  If  this  record  is  not  used,  then  Stokes  second-order  theory  is  used. 

“regNonlinearOption” ,  regNonlinear Option  (2  character  strings) 

“regNonlinearOption”  Record  tag. 

regNonlinearOption  Option  for  modelling  wave  nonlinearities: 

StokesSecond  -  Waves  are  modelled  using  Stokes 
second-order  theory  (default). 

Wheeler  -  Waves  are  modelled  using  Wheeler  stretching. 
Linear  -  Waves  are  modelled  using  linear  theory. 

Record  (8c),  End  of  Regular  Seaway 

This  record  is  required  if  seawayOption  in  Record  (7)  is  set  to  Regular. 

“end  regularSeaway”  (1  character  string  with  2  words) 

Record  (9),  Beginning  of  Unidirectional  Seaway  from  Input  Spectrum 

Records  (9)  to  (9g)  are  required  if  seawayOption  is  set  to  UniSpectrum  in  Record 

(7). 

“begin  uniSpectrumSeaway”  (1  character  string  with  2  words) 


38 


DRDC  Atlantic  TM  2011-308 


Record  (9a),  Wave  Frequency  Range 

One  of  Records  (9a)  or  (9b)  is  required  if  seawayOption  in  Record  (7)  is  set  to 
UniSpectrum. 

“waveFreqRange” ,  waveFreqMin,  waveFreqMax,  waveFreqlnc,  randomfncOption 
waveFreqSeed  (1  character  string,  3  floats,  1  character  string,  1  integer) 

“waveFreqRange”  Record  tag. 


waveFreqMin 

Minimum  wave  frequency  (rad/s). 

waveFreqMax 

Maximum  wave  frequency  (rad/s). 

waveFreqlnc 

Wave  frequency  increment  (rad/s). 

randomfncOption 

Option  for  random  wave  frequency  increment: 

Randomlnc  -  Intermediate  wave  frequencies  (i.e. ,  those  other 
than  the  minimum  and  maximum)  are  adjusted  by  randomly 
generated  increments  rounded  to  6  decimal  places.  This 
option  is  useful  for  avoiding  periodic  repetition  of  simulated 
seaways. 

Uniformlnc  -  The  wave  frequency  increment  between 
components  is  always  waveFreqlnc. 

waveFreqSeed 

Integer  seed  number  for  adjusting  wave  frequencies  if 
randomlncOption  is  set  to  Randomlnc. 

Record  (9b),  Wave  Frequencies 

One  of  Records  (9a)  or  (9b)  is  required  if  seawayOption  in  Record  (7)  is  set  to 
UniSpectrum. 

“waveFreqs”,  waveFreqs  (1  character  string,  array  of  floats) 

“waveFreqs”  Record  tag. 

waveFreqs  Array  of  increasing  wave  frequencies  (rad/s) 
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Record  (9c),  Wave  Phase  Seed  Number 

This  record  can  be  optionally  used  if  seawayOption  in  Record  (7)  is  set  to 
UniSpectrum.  If  this  record  is  omitted,  then  a  default  value  will  be  used. 

“phaseSeed”,  phaseSeed  (1  character  string,  1  integer) 

“phaseSeed”  Record  tag. 

phaseSeed  Integer  seed  number  (default  1001). 

Record  (9d),  Relative  Wave  Energy  Threshold 

This  record  can  be  optionally  used  if  seawayOption  in  Record  (7)  is  set  to 
UniSpectrum.  If  this  record  is  omitted,  then  a  default  value  will  be  used. 

“deleteRelThreshEnergy” ,  deleteRelThreshEnergy  (1  character  string,  1  real) 

“deleteRelThreshEnergy”  Record  tag. 

deleteRelThreshEnergy  Threshold  for  fraction  of  wave  energy  of  a  modelled 

seaway  component  (default  10-6).  If  the  relative 
energy  of  a  seaway  component  is  below  the  threshold, 
then  the  component  is  removed.  This  variable  is  used 
to  avoid  simulating  wave  spectral  components  with 
negligible  wave  energy. 

Record  (9e),  Wave  Heading 

This  record  is  required  if  seawayOption  in  Record  (7)  is  set  to  UniSpectrum. 
“waveHeading” ,  waveHeadingFromDeg  (1  character  string,  1  real) 

“waveHeading”  Record  tag. 

waveHeadingFromDeg  Wave  direction  v  (from,  degrees).  0°  for  waves  from 

north,  and  90°  for  waves  from  east. 
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Record  (9f),  Unidirectional  Wave  Spectrum  Option 

This  record  is  required  if  seawayOption  in  Record  (7)  is  set  to  UniSpectrum. 
“uniSpectrumOption” ,  uniSpectrumOption  (2  character  strings) 
“uniSpectrumOption”  Record  tag. 

uniSpectrumOption  Unidirectional  wave  spectrum  option: 

Bretschneider  -  Random  seaway  based  on  Bretschneider 
wave  spectrum. 

JONS  WAP  -  Random  seaway  based  on  JONS  WAP  wave 
spectrum. 

OchiHubble  -  Random  seaway  based  on  Ochi  and  Hubble 
six  parameter  wave  spectrum 

Input  -  Random  seaway  based  on  user-input  wave 
spectrum. 

Record  (9fl),  Unidirectional  Bretschneider  Spectrum  Seaway  Parame¬ 
ters 

This  record  is  required  if  uniSpectrumOption  in  Record  (9f)  is  set  to 
Bretschneider. 

“BretParam”,  hs,  tp  (1  character  string,  2  floats) 

“BretParam”  Record  tag. 
hs  Significant  wave  height  (m). 

tp  Peak  wave  period  (s). 

Record  (9f2),  Unidirectional  JONSWAP  Spectrum  Seaway  Parameters 

This  record  is  required  if  uniSpectrumOption  in  Record  (9f)  is  set  to  JONSWAP. 
“JONSWAPParam”,  hs,  tp,  peakEnhance  (1  character  string,  3  floats) 
“JONSWAPParam”  Record  tag. 
hs  Significant  wave  height  (m). 

tp  Peak  wave  period  (s). 

peakEnhance  Peak  enhancement  factor.  This  factor  can  be  set  to  3.3  to 

match  a  2  parameter  JONSWAP  spectrum. 
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Record  (9f3),  Unidirectional  Ochi  Hubble  Spectrum  Parameters 

This  record  is  required  if  uniSpectrumOption  in  Record  (9f)  is  set  to  OchiHubble. 

“OchiHubbleParam” ,  waveHeadingFromDeg,  hsl,  freqPeakl,  spectralShapel, 
hs2,  freqPeak2,  spectralShape2  (1  character  string,  6  floats) 


“OchiHubbleParam” 

hsl 

freqPeakl 

spectralShapel 

hs2 

freqPeak2 

spectralShape2 


Record  tag. 

Significant  wave  height  hs_ i  of  wave  system  1  (m). 
Peak  wave  frequency  ujp-i  of  wave  system  1  (rad/s). 
Spectral  shape  factor  Ai  of  wave  system  1. 
Significant  wave  height  hs_2  of  wave  system  2  (m). 
Peak  wave  frequency  ojp-2  of  wave  system  2  (rad/s). 
Spectral  shape  factor  A2  of  wave  system  2. 


Record  (9f4),  Unidirectional  Input  Spectrum  Wave  Frequencies 

This  record  is  required  if  uniSpectrumOption  in  Record  (9f)  is  set  to  Input, 
“input WaveFreqs” ,  input  WaveFreqs  (1  character  string,  array  of  floats) 

“input WaveFreqs”  Record  tag. 

input  WaveFreqs  Wave  frequencies  u>i  for  input  energy  densities  (rad/s). 

Record  (9f5),  Unidirectional  Input  Spectrum  Energy  Densities 

This  record  is  required  if  uniSpectrumOption  in  Record  (9f)  is  set  to  Input. 
“inputEnergyDensities” ,  inputEnergyDensities  (1  character  string,  array  of  floats) 
“inputEnergyDensities”  Record  tag. 

inputEnergyDensities  Wave  spectrum  energy  densities  SUl(coi)  (m2/(rad/s)) 

corresponding  to  wave  frequencies  of  Record  (9f4). 

Record  (9g),  End  of  Unidirectional  Seaway  from  Input  Spectrum 

This  record  is  required  if  seawayOption  in  Record  (7)  is  set  to  UniSpectrum. 

“end  uniSpectrumSeaway”  (1  character  string  with  2  words) 
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Record  (10),  Beginning  of  Bidirectional  Seaway  from  Input  Spectrum 

Records  (10)  to  (lOf)  are  required  if  seawayOption  is  set  to  BiSpectrum  in  Record 

(7). 

“begin  biSpectrumSeaway”  (1  character  string  with  2  words) 


Record  (10a),  Wave  Frequency  Range 

One  of  Records  (10a)  or  (10b)  is  required  if  seawayOption  in  Record  (7)  is  set  to 
BiSpectrum. 


“waveFreqRange” ,  waveFreqMin,  waveFreqMax,  waveFreqlnc,  randomlncOption, 
waveFreqSeed  (1  character  string,  3  floats,  1  character  string,  1  integer) 


“waveFreqRange,: 

waveFreqMin 

waveFreqMax 

waveFreqlnc 


Record  tag. 

Minimum  wave  frequency  (rad/s). 
Maximum  wave  frequency  (rad/s). 
Wave  frequency  increment  (rad/s). 


randomlncOption  Option  for  random  wave  frequency  increment. 

Randomlnc  -  Intermediate  wave  frequencies  (i.e. ,  those  other 
than  the  minimum  and  maximum)  are  randomly  adjusted, 
with  rounding  to  6  decimal  places.  This  option  is  useful  for 
avoiding  periodic  repetition  of  simulated  seaways. 

Uniformlnc  -  The  wave  frequency  increment  between 
components  is  always  waveFreqlnc. 

waveFreqSeed  Integer  seed  number  for  adjusting  wave  frequencies  if 
randomlncOption  is  set  to  randomlnc. 


Record  (10b),  Wave  Frequencies 

One  of  Records  (10a)  or  (10b)  is  required  if  seawayOption  in  Record  (7)  is  set  to 
BiSpectrum. 

“waveFreqs”,  waveFreqs  (1  character  string,  array  of  floats) 

“waveFreqs”  Record  tag. 

waveFreqs  Array  of  increasing  wave  frequencies  (rad/s) 
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Record  (10c),  Wave  Phase  Seed  Number 

This  records  can  be  optionally  used  if  seawayOption  in  Record  (7)  is  set  to 
BiSpectrum.  If  this  record  is  omitted,  then  a  default  will  be  used. 

“phaseSeed”,  phaseSeed  (1  character  string,  1  integer) 

“phaseSeed”  Record  tag. 

phaseSeed  Integer  seed  number  (default  1001). 

Record  (lOd),  Relative  Wave  Energy  Threshold 

This  record  can  be  optionally  used  if  seawayOption  in  Record  (7)  is  set  to 
BiSpectrum.  If  this  record  is  omitted,  then  a  default  value  will  be  used. 

“deleteRelThreshEnergy” ,  deleteRelThreshEnergy  (1  character  string,  1  float) 

“deleteRelThreshEnergy”  Record  tag. 

deleteRelThreshEnergy  Threshold  for  fraction  of  wave  energy  of  a  modelled 

seaway  component  (default  10-6).  If  the  relative 
energy  of  a  seaway  component  is  below  the  threshold, 
then  the  component  is  removed.  This  variable  is  used 
to  avoid  simulating  wave  spectral  components  with 
negligible  wave  energy. 

Record  (lOe),  Bidirectional  Wave  Spectrum  Option 

This  record  is  required  if  seawayOption  in  Record  (7)  is  set  to  BiSpectrum. 
“biSpectrumOption”,  biSpectrumOption  (2  character  strings) 

“biSpectrumOption”  Record  tag. 

biSpectrumOption  Bidirectional  wave  spectrum  option: 

BiBretschneider  -  Random  seaway  based  on  Bretschneider 
wave  spectrum. 

Bi  JONS  WAP  -  Random  seaway  based  on  JONS  WAP  wave 
spectrum. 


44 


DRDC  Atlantic  TM  2011-308 


Record  (lOel),  Bidirectional  Bretschneider  Spectrum  Seaway  Parame 
ters 

This  record  is  required  if  biSpectrumOption  in  Record  (lOe)  is  set  to 
Bretschneider. 

“biBretParam” ,  waveHeadingDegl,  hsl,  tpl,  waveHeadingDeg2,  hs2,  tp2  (1 
character  string,  6  floats) 

“biBretParam”  Record  tag. 


waveHeadingDegl 

Principle  wave  direction  of  first  wave  system  (from,  degrees) 
0°  for  waves  from  north,  and  90°  for  waves  from  east. 

hsl 

Significant  wave  height  of  first  wave  system  (m). 

tpl 

Peak  wave  period  of  first  wave  system  (s). 

waveHeadingDeg2 

Principle  wave  direction  of  second  wave  system  (from, 
degrees).  0°  for  waves  from  north,  and  90°  for  waves  from 
east. 

hs2 

Significant  wave  height  of  second  wave  system  (m). 

tp2 

Peak  wave  period  of  second  wave  system  (s). 
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Record  (10e2),  Bidirectional  JONSWAP  Spectrum  Seaway  Parameters 

This  record  is  required  if  biSpectrumOption  in  Record  (lOe)  is  set  to  JONSWAP. 

“biJONSWAPParam” ,  waveHeadingDegl,  hsl,  tpl,  peakEnhancel, 
waveHeadingDeg2,  hs2,  tp2,  peakEnhance2  (1  character  string,  8  floats) 

“biJONSWAPParam”  Record  tag. 


waveHeadingDegl 

Principle  wave  direction  of  first  wave  system  (from, 
degrees).  0°  for  waves  from  north,  and  90°  for  waves  from 
east. 

hsl 

Significant  wave  height  of  first  wave  system  (m). 

tpl 

Peak  wave  period  of  first  wave  system  (s). 

peakEnhancel 

Peak  enhancement  factor  of  first  wave  system.  This 
factor  can  be  set  to  3.3  to  match  a  2  parameter 
JONSWAP  spectrum. 

waveHeadingDeg2 

Principle  wave  direction  of  second  wave  system  (from, 
degrees).  0°  for  waves  from  north,  and  90°  for  waves  from 
east. 

hs2 

Significant  wave  height  of  second  wave  system  (m). 

tp2 

Peak  wave  period  of  second  wave  system  (s). 

peakEnhance2 

Peak  enhancement  factor  of  second  wave  system.  This 
factor  can  be  set  to  3.3  to  match  a  2  parameter 
JONSWAP  spectrum. 

Record  (10f),  End  of  Bidirectional  Seaway  from  Input  Spectrum 

This  record  is  required  if  seawayOption  in  Record  (7)  is  set  to  BiSpectrum. 

“end  biSpectrumSeaway”  (1  character  string  with  2  words) 

Record  (11),  Beginning  of  Seaway  from  Spectrum  with  Cosine-squared 
Spreading 

Records  (11)  to  (llj)  are  required  if  seawayOption  is  set  to  cosSpectrum  in 
Record  (7). 

“begin  cosSpectrumSeaway”  (1  character  string  with  2  words) 
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Record  (11a),  Wave  Frequency  Range 

One  of  Records  (11a)  or  (lib)  is  required  if  seawayOption  in  Record  (7)  is  set  to 
cosSpectrum. 


“waveFreqRange” ,  waveFreqMin,  waveFreqMax,  waveFreqlnc,  randomlncOption, 
waveFreqSeed  (1  character  string,  3  floats,  1  character  string,  1  integer) 


“waveFreqRange” 

waveFreqMin 

waveFreqMax 

waveFreqlnc 

randomlncOption 


Record  tag. 

Minimum  wave  frequency  (rad/s). 

Maximum  wave  frequency  (rad/s). 

Wave  frequency  increment  (rad/s). 

Option  for  random  wave  frequency  increment. 


Randomlnc  -  Intermediate  wave  frequencies  (i.e. ,  those  other 
than  the  minimum  and  maximum)  are  adjusted  by  randomly 
generated  increments  rounded  to  6  decimal  places.  This 
option  is  useful  for  avoiding  periodic  repetition  of  simulated 
seaways. 

Uniformlnc  -  The  wave  frequency  increment  between 
components  is  always  waveFreqlnc. 

waveFreqSeed  Integer  seed  number  for  adjusting  wave  frequencies  if 
randomlncOption  is  set  to  randomlnc. 


Record  (lib),  Wave  Frequencies 

One  of  Records  (11a)  or  (lib)  is  required  if  seawayOption  in  Record  (7)  is  set  to 
cosSpectrum 

“waveFreqs”,  waveFreqs  (1  character  string,  array  of  floats 
“waveFreqs”  Record  tag. 

waveFreqs  Array  of  increasing  wave  frequencies  (rad/s) 
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Record  (11c),  Wave  Heading  Range 

One  of  Records  (11c)  or  (lid)  is  required  if  seawayOption  in  Record  (7)  is  set  to 
cosSpectrum. 

“waveHeadingRange” ,  waveHeadingMinDeg,  waveHeadingMaxDeg, 
waveHeadinglncDeg  (1  character  string,  3  floats) 

“waveHeadingRange”  Record  tag. 

waveHeadingMinDeg  Minimum  wave  heading  (deg). 

waveHeadingMaxDeg  Maximum  wave  heading  (deg). 

waveHeadinglncDeg  Wave  heading  increment  (deg). 

Record  (lid),  Wave  Headings 

One  of  Records  (11c)  or  (lid)  is  required  if  seawayOption  in  Record  (7)  is  set  to 
cosSpectrum 

“waveHeadings” ,  waveHeadings  (1  character  string,  array  of  floats) 
“waveHeadings”  Record  tag. 

waveHeadingsDeg  Array  of  increasing  wave  headings  (deg). 

Record  (He),  Wave  Phase  Seed  Number 

This  records  can  be  optionally  used  if  seawayOption  in  Record  (7)  is  set  to 
cosSpectrum.  If  this  record  is  omitted,  then  a  default  will  be  used. 

“phaseSeed”,  phaseSeed  (1  character  string,  1  integer) 

“phaseSeed”  Record  tag. 

phaseSeed  Integer  seed  number  (default  1001). 
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Record  (Ilf),  Relative  Wave  Energy  Threshold 

This  record  can  be  optionally  used  if  seawayOption  in  Record  (7)  is  set  to 
cosSpectrum.  If  this  record  is  omitted,  then  a  default  value  will  be  used. 

“deleteRelThreshEnergy” ,  deleteRclThreshEnergy  (1  character  string,  1  real 

“deleteRelThreshEnergy”  Record  tag. 

deleteRelThreshEnergy  Threshold  for  fraction  of  wave  energy  of  a  modelled 

seaway  component  (default  10-6).  If  the  relative 
energy  of  a  seaway  component  is  below  the  threshold, 
then  the  component  is  removed.  This  variable  is  used 
to  avoid  simulating  wave  spectral  components  with 
negligible  wave  energy. 

Record  (llg),  Mean  Wave  Heading 

This  record  is  required  if  seawayOption  in  Record  (7)  is  set  to  CosSpectrum. 
“waveHeadingMean” ,  waveHeadingMeanDeg  (1  character  string,  1  real) 
“waveHeadingMean”  Record  tag. 

waveHeadingMeanDeg  Mean  wave  direction  v  (from,  degrees).  0°  for  waves 

from  north,  and  90°  for  waves  from  east. 

Record  (llh),  Wave  Spreading  Angle 

This  record  is  required  if  seawayOption  in  Record  (7)  is  set  to  CosSpectrum. 
“spreadAngle” ,  spreadAngleDeg  (1  character  string,  1  float) 

“spreadAngle”  Record  tag. 

spreadAngleDeg  Directional  spreading  angle  (deg). 
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Record  (Hi),  Cosine-squared  Spreading  Wave  Spectrum  Option 

This  record  is  required  if  seawayOption  in  Record  (7)  is  set  to  cosSpectrum. 
“cosSpectrumOption” ,  cosSpectrumOption  (2  character  strings 
“cosSpectrumOption”  Record  tag. 

cosSpectrumOption  Cosine-squared  wave  spectrum  option: 

CosBretschneider  -  Random  seaway  based  on 
Bretschneider  wave  spectrum  with  cosine-squared 
spreading  function. 

CosJONSWAP  -  Random  seaway  based  on  JONSWAP 
wave  spectrum  with  cosine-squared  spreading  function. 


Record  (llil),  Cosine-squared  Spreading  Bretschneider  Spectrum  Sea¬ 
way  Parameters 

This  record  is  required  if  cosSpectrumOption  in  Record  (lli)  is  set  to 
CosBretschneider. 

“BretParam”,  hs,  tp  (1  character  string,  2  floats) 

“BretParam”  Record  tag. 
hs  Significant  wave  height  (m). 

tp  Peak  wave  period  (s). 


Record  (lli2),  Cosine-squared  Spreading  JONSWAP  Spectrum  Seaway 
Parameters 

This  record  is  required  if  cosSpectrumOption  in  Record  (lli)  is  set  to 
CosJONSWAP. 


“JONSWAPParam”, 

“JONSWAPParam” 

hs 

tp 

peakEnhance 


hs,  tp,  peakEnhance  (1  character  string,  3  floats) 

Record  tag. 

Significant  wave  height  (m). 

Peak  wave  period  (s). 

Peak  enhancement  factor.  This  factor  can  be  set  to  3.3  to 
match  a  2  parameter  JONSWAP  spectrum. 
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Record  ( 1 1  j ) ,  End  of  Seaway  with  from  Spectrum  with  Cosine-squared 
Spreading 

This  record  is  required  if  seawayOption  in  Record  (7)  is  set  to  cosSpectrum. 

“end  cosSpectrumSeaway”  (1  character  string  with  2  words) 


Record  (12),  Beginning  of  Directional  Seaway  from  Input  Spectrum 

Records  (12)  to  (12i)  are  required  if  seawayOption  is  set  to  dirSpectrum  in 
Record  (7). 

“begin  dirSpectrumSeaway”  (1  character  string  with  2  words) 


Record  (12a),  Wave  Frequency  Range 

One  of  Records  (12a)  or  (12b)  is  required  if  seawayOption  in  Record  (7)  is  set  to 
dirSpectrum. 


“waveFreqRange” ,  waveFreqMin,  waveFreqMax,  waveFreqlnc,  randomlncOption, 
waveFreqSeed  (1  character  string,  3  floats,  1  character  string,  1  integer) 


“waveFreqRange” 

waveFreqMin 

waveFreqMax 

waveFreqlnc 


Record  tag. 

Minimum  wave  frequency  (rad/s). 
Maximum  wave  frequency  (rad/s). 
Wave  frequency  increment  (rad/s). 


randomlncOption  Option  for  random  wave  frequency  increment. 

Randomlnc  -  Intermediate  wave  frequencies  (i.e. ,  those  other 
than  the  minimum  and  maximum)  are  adjusted  by  randomly 
generated  increments  rounded  to  6  decimal  places.  This 
option  is  useful  for  avoiding  periodic  repetition  of  simulated 
seaways. 


Uniformlnc  -  The  wave  frequency  increment  between 
components  is  always  waveFreqlnc. 


waveFreqSeed  Integer  seed  number  for  adjusting  wave  frequencies  if 
randomlncOption  is  set  to  randomlnc. 
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Record  (12b),  Wave  Frequencies 

One  of  Records  (12a)  or  (12b)  is  required  if  seawayOption  in  Record  (7)  is  set  to 
dirSpectrum 

“waveFreqs”,  waveFreqs  (1  character  string,  array  of  floats 
“waveFreqs”  Record  tag. 

waveFreqs  Array  of  increasing  wave  frequencies  (rad/s) 

Record  (12c),  Wave  Fleading  Range 

One  of  Records  (12c)  or  (12d)  is  required  if  seawayOption  in  Record  (7)  is  set  to 
dirSpectrum. 

“waveHeadingRange” ,  waveHeadingMinDeg,  waveHeadingMaxDeg, 
waveHeadinglncDeg  (1  character  string,  3  floats) 

“waveHeadingRange”  Record  tag. 

waveHeadingMinDeg  Minimum  wave  heading  (deg). 

waveHeadingMaxDeg  Maximum  wave  heading  (deg). 

waveHeadinglncDeg  Wave  heading  increment  (deg). 

Record  (12d),  Wave  Fleadings 

One  of  Records  (12c)  or  (12d)  is  required  if  seawayOption  in  Record  (7)  is  set  to 
DirSpectrum. 

“waveHeadings” ,  wave  Headings  (1  character  string,  array  of  floats) 
“waveHeadings”  Record  tag. 

waveHeadingsDeg  Array  of  increasing  wave  headings  (deg). 

Record  (12e),  Wave  Phase  Seed  Number 

This  records  can  be  optionally  used  if  seawayOption  in  Record  (7)  is  set  to 
DirSpectrum.  If  this  record  is  omitted,  then  a  default  will  be  used. 

“phaseSeed”,  phaseSeed  (1  character  string,  1  integer) 

“phaseSeed”  Record  tag. 

phaseSeed  Integer  seed  number  (default  1001). 
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Record  (12f),  Relative  Wave  Energy  Threshold 

This  record  can  be  optionally  used  if  seawayOption  in  Record  (7)  is  set  to 
DirSpectrum.  If  this  record  is  omitted,  then  a  default  value  will  be  used. 

“deleteRelThreshEnergy” ,  deleteRclThreshEnergy  (1  character  string,  1  float) 

“deleteRelThreshEnergy”  Record  tag. 

deleteRelThreshEnergy  Threshold  for  fraction  of  wave  energy  of  a  modelled 

seaway  component  (default  10-6).  If  the  relative 
energy  of  a  seaway  component  is  below  the  threshold, 
then  the  component  is  removed.  This  variable  is  used 
to  avoid  simulating  wave  spectral  components  with 
negligible  wave  energy. 

Record  (12g),  Multidirectional  Wave  Spectrum  Option 

This  record  is  required  if  seawayOption  in  Record  (7)  is  set  to  DirSpectrum. 
“dirSpectrumOption”,  dirSpectrumOption  (2  character  strings) 
“dirSpectrumOption”  Record  tag. 

dirSpectrumOption  Multidirectional  wave  spectrum  option: 

TenParameter  -  Random  seaway  based  on  ten  parameter 
wave  spectrum. 

EndecoWaveBuoy  -  Random  seaway  based  on  directional 
spectrum  from  Endeco  956  or  1156  wave  buoy. 

InputDir  -  Input  directional  spectrum.  The  format  of  the 
spectrum  is  given  in  Annex  A. 2. 
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Record  (12gl),  Multidirectional  Ten  Parameter  Spectrum  Seaway  Pa¬ 
rameters 

This  record  is  required  if  dirSpectrumOption  in  Record  (12g)  is  set  to 
TenParameter. 

“tenParamParam” ,  hsl,  freqPeakl,  spectralShapel,  waveHeadingMeanDegl, 
dirSpreadExpl,  hs2,  freqPeak2,  spectralShape2,  waveHeadingMeanDeg2, 
dirSpreadExp2  (1  character  string,  10  floats) 

“tenParamParam”  Record  tag. 


hsl 

Significant  wave  height  of  wave  system  1  (m). 

freqPeakl 

Peak  wave  frequency  of  wave  system  1  (rad/s). 

spectralShapel 

Spectral  shape  factor  of  wave  system  1  (rad/s). 

waveHeadingMeanDegl 

Principle  wave  direction  (from,  degrees)  of  wave  system 
1.  0°  for  waves  from  north,  and  90°  for  waves  from  east. 

dirSpreadExpl 

Directional  spreading  exponent  of  wave  system  1. 

hs2 

Significant  wave  height  of  wave  system  2  (m). 

freqPeak2 

Peak  wave  frequency  of  wave  system  2  (rad/s). 

spectralShape2 

Spectral  shape  factor  of  wave  system  2  (rad/s). 

waveHeadingMeanDeg2 

Principle  wave  direction  (from,  degrees)  of  wave  system 
2.  0°  for  waves  from  north,  and  90°  for  waves  from  east. 

dirSpreadExp2 

Directional  spreading  exponent  of  wave  system  2. 

Record  (12g2),  Endeco  Wave  Spectrum  File  Name 

This  record  is  required  if  dirSpectrumOption  in  Record  (12g)  is  set  to 
Endeco  WaveBuoy. 

“EndecoSpectrumFileName” ,  EndecoSpectrumFileName  (2  character  strings) 
“EndecoSpectrumFileName”  Record  tag. 

EndecoSpectrumFileName  Name  of  ASCII  file  with  wave  spectrum  from 

Endeco  956  or  1156  wave  buoy.  The  file  name  will 
typically  have  the  extension  “.std” . 
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Record  (12h),  Input  Directional  Wave  Spectrum  File  Name 

This  record  is  required  if  dirSpectrumOption  in  Record  (12g)  is  set  to  InputDir. 
“inputDirSpectrumFileName”,  inputDirSpectrumFileName  (2  character  strings) 
“inputDirSpectrumFileName”  Record  tag. 

inputDirSpectrumFileName  Input  directional  wave  spectrum  hie  name.  The 

format  of  the  directional  wave  spectrum  hie  is 
given  in  Annex  A. 2. 

Record  (12i),  End  of  Multi-directional  Seaway  from  Input  Spectrum 

This  record  is  required  if  seawayOption  in  Record  (7)  is  set  to  DirSpectrum. 

“end  dir SpectrumSeaway”  (1  character  string  with  2  words) 

Record  (13),  Beginning  of  Seaway  from  Input  Components,  Randomly 
Generated  Phases 

Records  (13)  to  (13c)  are  required  if  seawayOption  is  set  to  componentRandom  in 
Record  (7). 

“begin  componentRandomSeaway”  (1  character  string  with  2  words) 

Record  (13a),  Wave  Phase  Seed  Number 

This  record  can  be  optionally  used  if  seawayOption  in  Record  (7)  is  set  to 
componentRandom.  If  this  record  is  omitted,  then  a  default  will  be  used. 

“compPhaseSeed” ,  seed  (1  character  string,  1  integer) 

“compPhaseSeed”  Record  tag. 

phaseSeed  Integer  seed  number  (default  1001). 
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Record  (13b),  Wave  Component  Properties 

This  record  can  be  repeated  to  describe  a  seaway  consisting  of  multiple  wave 
components. 

“componentRandom” ,  waveHeadingDeg,  waveFreq,  waveAmp  (1  character  string, 
3  floats) 

“componentRandom”  Record  tag. 

waveHeadingDeg  Wave  direction  (from,  degrees).  0°  for  waves  from  north, 

and  90°  for  waves  from  east. 

waveFreq  Incident  wave  frequency  (rad/s). 

waveAmp  Incident  wave  amplitude  (m). 

Record  (13c),  End  of  Seaway  from  Input  Components,  Randomly 
Generated  Phases 

This  record  is  required  if  seawayOption  is  set  to  ComponentRandom  in  Record 

(7). 

“end  componentRandomSeaway”  (1  character  string  with  2  words) 

Record  (14),  Beginning  of  Seaway  from  Input  Components  Including 
Phases 

Records  (14)  to  (14b)  are  required  if  seawayOption  is  set  to  ComponentPhase  in 
Record  (7). 

“begin  componentPhaseSeaway”  (1  character  string  with  2  words) 
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Record  (14a),  Wave  Component  Properties 

This  record  can  be  repeated  to  describe  a  seaway  consisting  of  multiple  wave 
components. 

“componentPhase”,  waveHeadingDeg,  waveFreq,  waveAmp,  phaseDeg  (1 
character  string,  4  floats) 


“componentPhase’1 

waveHeadingDeg 

waveFreq 

waveAmp 

phaseDeg 


Record  tag. 

Wave  direction  (from,  degrees).  0°  for  waves  from  north, 
and  90°  for  waves  from  east. 

Incident  wave  frequency  (rad/s). 

Incident  wave  amplitude  (m). 

Phase  of  incident  wave  crest  at  x?  —  0,  yf  —  0  (deg). 


Record  (14b),  End  of  Seaway  from  Input  Components  with  Input 
Phases 

This  record  is  required  if  seawayOption  is  set  to  componentPhase  in  Record  (7). 
“end  componentPhaseSeaway”  (1  character  string  with  2  words) 


Record  (15),  Plot  Output  Option 

This  record  is  optional. 

“plotOutOption” ,  plotOutOption  (2  character  strings) 

“plotOutOption”  Record  tag. 
plotOutOption  Option  for  making  plots: 

NoPlot  -  No  plots  are  produced. 

Screen  -  Plots  are  only  plotted  on  the  screen  (default). 
ScreenFile  -  Plots  are  both  plotted  on  the  screen  and  to  a  hie. 
File  -  Plots  are  only  written  to  a  hie. 
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Record  (16),  Beginning  of  Seaway  Plot  Data 

This  record  is  optional. 

“begin  plots”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (16a)  to  (16j)  giving  plot  parameters.  Record 
(16k)  must  follow  at  the  end  of  plot  parameter  data. 

Record  (16a),  Seaway  Plot  Image  File  Name 

This  record  is  required  if  a  plot  is  being  specified. 

“imageFileName” ,  imageFileName  (2  character  strings) 

“imageFileName”  Record  tag. 
imageFileName  Name  of  output  plot  file. 

Record  (16b),  Seaway  Plot  Image  Format 

This  record  is  optional  if  a  plot  is  being  specified. 

“imageFormat” ,  imageFormat  (2  character  strings) 

“imageFormat”  Record  tag. 

imageFormat  Plot  image  format.  Available  formats  are  png  (default)  and  jpg. 

Record  (16c),  Seaway  Plot  Image  Size 

This  record  is  optional  if  a  plot  is  being  specified. 

“imageSize”,  widthmm,  heightmm  (1  character  string,  2  floats) 

“imageSize”  Record  tag. 

widthmm  Plot  width  (mm).  (Default  150  mm) 

heightmm  Plot  height  (mm).  (Default  100  mm) 
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Record  (16d),  Seaway  Plot  Camera  Settings 

This  record  is  required  if  a  plot  is  being  specified. 

“camera”,  camPosHorAngleDeg,  carnPos VertAngleDeg,  camViewAngleDeg  (1 
character  string,  3  floats) 


1  camera 


Record  tag. 


camPosHorAngleDeg  Horizontal  position  (deg)  of  camera  relative  to  seaway  (0° 

for  front,  90°  for  left). 

camPosHorAngleDeg  Vertical  position  (deg)  of  camera  relative  to  seaway  (0°  for 

horizontal,  90°  for  above). 

camViewAngleDeg  Camera  view  angle  (deg). 


Record  (16e),  Seaway  Plot  Lighting  Settings 

This  record  is  optional  if  a  plot  is  being  specified. 

“lighting” ,  ambientLightlntensity,  directLightlntensity,  directLightHor AngleDeg, 
direct  Light VertAngleDeg  (1  character  string,  3  floats) 


Record  tag. 

Ambient  light  intensity  (default  0.5). 

Direct  light  intensity  (default  1.0). 

Horizontal  position  (deg)  of  direct  light  source  relative 
to  seaway  (0°  for  front,  90°  for  left,  default  0°). 

directLight VertAngleDeg  Vertical  position  (deg)  of  direct  light  source  to  seaway 

(0°  for  horizontal,  90°  for  above,  default  45°). 


“lighting” 

ambientLightlntensity 

directLightlntensity 

directLightHorAngleDeg 
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Record  (16f),  Seaway  Plot  Options 

This  record  is  required  if  a  plot  is  being  specified. 

“plotOptions” ,  colour  Table,  smoothShadeOption,  showMeshOption  (4  character 
strings) 

“plotOptions”  Record  tag. 

colour  Table  Colour  table: 

BlueGreenRedScale  -  Elevation  colours  ranging  from  blue 
to  red. 

PartialGreyScale  -  Elevation  colours  ranging  from  grey  to 
white. 

GreyScale  -  Elevation  colours  ranging  from  black  to  white. 

BlueTurquoiseScale  -  Elevation  colours  ranging  from  blue 
to  turquoise. 

BlueWhiteScale  -  Elevation  colours  ranging  from  blue  to 
white. 

WhiteScale  -  Solid  white 

smoothShadeOption  Option  for  shading  of  seaway  panels: 

Solid  -  Each  panel  has  a  solid  colour  based  on  the  centroid 
location. 

Smooth  -  Each  panel  can  have  colour  variation  within  the 
panel. 

showMeshOption  Option  for  plotting  the  mesh: 

ShowMesh  -  The  seaway  surface  mesh  is  plotted. 

HideMesh  -  No  surface  mesh  is  plotted. 
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Record  (16g),  X  Plot  Range 

This  record  is  required  if  a  plot  is  being  specified. 

“xfRange”,  xfMin,  xfMax,  xflnc  (1  character  string,  3  floats) 
“xfRange”  Record  tag. 

xfMin  Minimum  x *  coordinate  of  surface  mesh. 

xfMax  Maximum  x-'  coordinate  of  surface  mesh, 

xflnc  Increment  of  x*  coordinate  of  surface  mesh. 

Record  (16h),  Y  Plot  Range 

This  record  is  required  if  a  plot  is  being  specified. 

“yfRange”,  yfMin,  yfMay,  yflnc  (1  character  string,  3  floats) 
“yfRange”  Record  tag. 

yfMin  Minimum  y*  coordinate  of  surface  mesh. 

yfMay  Maximum  yf  coordinate  of  surface  mesh, 

yflnc  Increment  of  y*  coordinate  of  surface  mesh. 

Record  (16i),  Time  of  plot. 

This  record  is  optional  if  a  plot  is  being  specified. 

“time”,  time  (1  character  string,  1  floats) 

“time”  Record  tag. 

time  Time  at  which  sea  surface  is  plotted  (default  0.0). 

Record  ( 1 6 j ) ,  Mesh  Line  Thickness 

This  record  is  optional  if  a  plot  is  being  specified. 
“lineThickness’,  lineThickness  (1  character  string,  1  float) 
“lineThickness”  Record  tag. 

lineThickness  Line  thickness  of  mesh  (default  1.0). 

Record  (16k),  End  of  Plot  Data 

“end  plots”  (1  character  string  with  2  words) 
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Record  (IT),  End  of  Seaway 

“end  SM3DBuildSeaway3”  (1  character  string  with  2  words) 


62 


DRDC  Atlantic  TM  2011-308 


A.2  Format  of  Input  Directional  Spectrum  File  for 
S  M3  D  B  u  i  I  d  Sea  way  3 

Record  (1),  Beginning  Record 

“begin  inputDirSpectrum”  (1  character  string  with  2  words) 

Record  (2),  Run  Label 

“label” ,  label  (2  character  strings) 

“label”  Record  tag. 

label  Label  for  spectrum.  This  can  include  spaces. 

Record  (3),  Significant  Wave  Height  and  Characteristic  Wave  Period 

“hsTchar”,  hs,  tChar  (1  character  string,  2  floats) 

“hsTchar”  Record  tag. 
hs  Significant  wave  height  (m) 

tChar  Characteristic  wave  period  (s) 

Record  (4a),  Range  of  Wave  Frequencies 

One  of  Records  (4a)  or  (4b)  must  be  given. 

“waveFreqRange” ,  waveFreqMin,  waveFreqMax,  waveFreqlnc  (1  character  string, 
3  floats) 

“waveFreqRange”  Record  tag. 

waveFreqMin  Minimum  wave  frequency  (rad/s). 

waveFreqMax  Maximum  wave  frequency  (rad/s). 

waveFreqlnc  Increment  for  wave  frequency  (rad/s). 

Record  (4b),  Wave  Frequencies 

One  of  Records  (4b)  or  (4b)  must  be  given. 

“waveFreqs”,  waveFreqs  (1  character  string,  array  of  floats) 

“waveFreqs”  Record  tag. 

waveFreqs  Array  of  increasing  incident  wave  frequencies  (rad/s). 
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Record  (5a),  Wave  Direction  Range 

One  of  Records  (5a)  or  (5b)  must  be  given. 

“waveDirFromRange” ,  waveDirFromDegMin,  waveDirFromDegMax, 
waveDirFromDeglnc  (1  character  string,  3  floats) 


“waveDirFromRange” 

waveDirFromDegMin 


Record  tag. 

Minimum  wave  direction  (deg). 


waveDirFromDegMax  Maximum  wave  direction  (deg). 


waveDirFromDeglnc 

Note: 


Wave  direction  increment  (deg). 

Wave  directions  are  given  using  a  convention  of  0°  for 
waves  from  north,  90°  for  waves  from  east. 


Record  (5b),  Wave  Directions 

One  of  Records  (5a)  or  (5b)  must  be  given. 

“waveDirsFrom” ,  waveDirsFromDeg  (1  character  string,  array  of  floats) 
“waveDirsFrom”  Record  tag. 

waveDirsFromDeg  Wave  directions  for  integration  of  ship  motion  spectrum. 

Wave  directions  are  given  using  a  convention  of  0°  for  waves 
from  north,  90°  for  waves  from  east. 


Record  (6),  Wave  Energy  Spectral  Densities  for  Specified  Wave  Fre¬ 
quencies. 

nWaveFreq  Records  must  be  given,  where  nWaveFreq  is  the  number  of  wave 
frequencies  specified  by  Record  (4a)  or  (4b) 

“energyDensities” ,  waveFreq,  energyDensitiesDirDeg  (1  character  string,  1  + 
nWaveDir  floats) 

“energyDensities”  Record  tag. 

waveFreq  Wave  frequency  for  energy  densities  within  Record.  This 

value  must  be  consistent  with  wave  frequencies  specified 
by  Record  (4a)  or  (4b). 

energyDensitiesDirDeg  Energy  densities  (m2/ (rad/s) /deg)  for  frequency 

waveFreq  and  wave  directions  specified  in  Record  (5a)  or 
(5b). 
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Record  (7),  End  Record 

“end  inputDirSpectrum”  (1  character  string  with  2  words) 
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A.3  Sample  Input  Directional  Spectrum  File  for 
SM3DBuildSeaway3 

begin  inputDirSpectrum 

label  Bretschenider  spectrum,  Hs  =  5.0  m,  Tp  =  12.4  s,  heading  =  180  deg,  ! 

spreading  =  90  deg 

hsTchar  5.0  12.4 


waveFreqRange  0.2  2.0  0.05 


waveDirFromRange 

90.0  270. 

0  5.0 

energyDensities 

0.200 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

energyDensities 

0.250 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

0.000000 

energyDensities 

0.300 

0.000000 

0.000001 

0.000003 

0.000006 

0.000010 

0.000016 

0.000022 

0.000030 

0.000037 

0.000045 

0.000053 

0.000060 

0.000067 

0.000074 

0.000079 

0.000084 

0.000087 

0.000089 

0.000090 

0.000089 

0.000087 

0.000084 

0.000079 

0.000074 

0.000067 

0.000060 

0.000053 

0.000045 

0.000037 

0.000030 

0.000022 

0.000016 

0.000010 

0.000006 

0.000003 

0.000001 

0.000000 

energyDensities 

0.350 

0.000000 

0.000034 

0.000135 

0.000300 

0.000524 

0.000801 

0.001120 

0.001475 

0.001852 

0.002241 

0.002630 

0.003007 

0.003361 

0.003681 

0.003958 

0.004182 

0.004347 

0 . 004448 

0 . 004482 

0 . 004448 

0.004347 

0.004182 

0.003958 

0.003681 

0.003361 

0.003007 

0.002630 

0.002241 

0.001852 

0.001475 

0.001120 

0.000801 

0.000524 

0.000300 

0.000135 

0.000034 

0.000000 

energyDensities 

0.400 

0.000000 

0.000169 

0.000673 

0.001494 

0.002609 

0.003984 

0.005576 

0.007338 

0.009216 

0.011152 

0.013089 

0.014967 

0.016729 

0.018321 

0.019696 

0.020811 

0.021632 

0.022135 

0.022305 

0.022135 

0.021632 

0.020811 

0.019696 

0.018321 

0.016729 

0.014967 

0.013089 

0.011152 

0.009216 

0.007338 

0.005576 

0.003984 

0.002609 

0.001494 

0.000673 

0.000169 

0.000000 

energyDensities 

0.450 

0.000000 

0.000315 

0.001251 

0.002779 

0.004852 

0.007409 

0.010370 

0.013647 

0.017139 

0.020741 

0.024342 

0.027834 

0.031111 

0.034072 

0.036629 

0.038703 

0.040230 

0.041166 

0.041481 

0.041166 

0.040230 

0.038703 

0.036629 

0.034072 

0.031111 

0.027834 

0.024342 

0.020741 

0.017139 

0.013647 

0.010370 

0.007409 

0.004852 

0.002779 

0.001251 

0.000315 

0.000000 

energyDensities 

0.500 

0.000000 

0.000371 

0.001474 

0.003275 

0.005719 

0.008732 

0.012222 

0.016083 

0.020199 

0.024444 

0.028688 

0.032804 

0.036666 

0.040156 

0.043169 

0.045613 

0.047413 

0.048516 

0 . 048887 

0.048516 

0.047413 

0.045613 

0.043169 

0.040156 

0.036666 

0.032804 

0.028688 

0.024444 

0.020199 

0.016083 

0.012222 

0.008732 

0.005719 
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0.003275 

0.001474 

0.000371 

energyDensities 

0.550 

0.000000 

0.008234 

0.011526 

0.015168 

0.034578 

0.037870 

0.040711 

0.045754 

0.044714 

0.043016 

0.027055 

0.023052 

0.019049 

0.003088 

0.001390 

0.000350 

energyDensities 

0.600 

0.000000 

0.006945 

0.009721 

0.012792 

0.029162 

0.031938 

0.034334 

0.038587 

0.037710 

0.036278 

0.022817 

0.019441 

0.016065 

0.002605 

0.001172 

0.000295 

energyDensities 

0.650 

0.000000 

0.005540 

0.007754 

0.010204 

0.023263 

0.025477 

0.027389 

0.030781 

0.030082 

0.028939 

0.018201 

0.015508 

0.012815 

0.002078 

0.000935 

0.000236 

energyDensities 

0.700 

0.000000 

0.004305 

0.006026 

0.007930 

0.018079 

0.019800 

0.021285 

0.023922 

0.023378 

0.022490 

0.014145 

0.012052 

0.009960 

0.001615 

0.000727 

0.000183 

energyDensities 

0.750 

0.000000 

0.003312 

0.004636 

0.006101 

0.013909 

0.015233 

0.016376 

0.018404 

0.017986 

0.017303 

0.010883 

0.009273 

0.007662 

0.001242 

0.000559 

0.000141 

energyDensities 

0.800 

0.000000 

0.002545 

0.003563 

0.004688 

0.010688 

0.011705 

0.012583 

0.014142 

0.013821 

0.013296 

0.008362 

0.007125 

0.005888 

0.000955 

0.000430 

0.000108 

energyDensities 

0.850 

0.000000 

0.001963 

0.002747 

0.003616 

0.008242 

0.009027 

0.009704 

0.010906 

0.010659 

0.010254 

0.006449 

0.005495 

0.004541 

0.000736 

0.000331 

0.000083 

energyDensities 

0.900 

0.000000 

0.001523 

0.002132 

0.002806 

0.006397 

0.007006 

0.007531 

0.008464 

0.008272 

0.007957 

0.005005 

0.004264 

0.003524 

0.000571 

0.000257 

0.000065 

energyDensities 

0.950 

0.000000 

0.001191 

0.001667 

0.002194 

000000 

000350 

0.001390 

0.003088 

0.005393 

019049 

0.023052 

0.027055 

0.030936 

043016 

0.044714 

0.045754 

0.046104 

040711 

0.037870 

0.034578 

0.030936 

015168 

0.011526 

0.008234 

0.005393 

000000 

000295 

0.001172 

0.002605 

0 . 004548 

016065 

0.019441 

0.022817 

0.026090 

036278 

0.037710 

0.038587 

0.038882 

034334 

0.031938 

0.029162 

0.026090 

012792 

0.009721 

0.006945 

0 . 004548 

000000 

000236 

0.000935 

0.002078 

0.003628 

012815 

0.015508 

0.018201 

0.020813 

028939 

0.030082 

0.030781 

0.031017 

027389 

0.025477 

0.023263 

0.020813 

010204 

0.007754 

0.005540 

0.003628 

000000 

000183 

0.000727 

0.001615 

0.002820 

009960 

0.012052 

0.014145 

0.016175 

022490 

0.023378 

0.023922 

0.024105 

021285 

0.019800 

0.018079 

0.016175 

007930 

0.006026 

0.004305 

0.002820 

000000 

000141 

0.000559 

0.001242 

0.002169 

007662 

0.009273 

0.010883 

0.012444 

017303 

0.017986 

0.018404 

0.018545 

016376 

0.015233 

0.013909 

0.012444 

006101 

0.004636 

0.003312 

0.002169 

000000 

000108 

0.000430 

0.000955 

0.001667 

005888 

0.007125 

0.008362 

0.009562 

013296 

0.013821 

0.014142 

0.014250 

012583 

0.011705 

0.010688 

0.009562 

004688 

0.003563 

0.002545 

0.001667 

000000 

000083 

0.000331 

0.000736 

0.001286 

004541 

0.005495 

0.006449 

0.007374 

010254 

0.010659 

0.010906 

0.010990 

009704 

0.009027 

0.008242 

0.007374 

003616 

0.002747 

0.001963 

0.001286 

000000 

000065 

0.000257 

0.000571 

0.000998 

003524 

0.004264 

0.005005 

0.005723 

007957 

0.008272 

0.008464 

0.008529 

007531 

0.007006 

0.006397 

0.005723 

002806 

0.002132 

0.001523 

0.000998 

000000 

000051 

0.000201 

0 . 000447 

0 . 000780 

002756 

0.003335 

0.003914 

0 . 004475 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 
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0 

0 

0 
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0 

0 

0 

0 

0 

0 

0 

0 
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0.005002 

0.005478 

0.005889 

0.006619 

0.006468 

0.006223 

0.003914 

0.003335 

0.002756 

0.000447 

0.000201 

0.000051 

energyDensities 

1.000 

0.000000 

0.000939 

0.001315 

0.001730 

0.003944 

0.004319 

0.004643 

0.005219 

0.005100 

0.004906 

0.003086 

0.002629 

0.002173 

0.000352 

0.000159 

0.000040 

energyDensities 

1.050 

0.000000 

0.000747 

0.001045 

0.001375 

0.003136 

0.003434 

0.003692 

0.004149 

0.004055 

0.003901 

0.002453 

0.002090 

0.001727 

0.000280 

0.000126 

0.000032 

energyDensities 

1.100 

0.000000 

0.000599 

0.000838 

0.001103 

0.002514 

0.002753 

0.002959 

0.003326 

0.003250 

0.003127 

0.001967 

0.001676 

0.001385 

0.000225 

0.000101 

0.000025 

energyDensities 

1.150 

0.000000 

0.000484 

0.000677 

0.000891 

0.002031 

0.002225 

0.002391 

0.002688 

0.002627 

0.002527 

0.001589 

0.001354 

0.001119 

0.000181 

0.000082 

0.000021 

energyDensities 

1.200 

0.000000 

0.000394 

0.000551 

0.000726 

0.001654 

0.001811 

0.001947 

0.002189 

0.002139 

0.002058 

0.001294 

0.001103 

0.000911 

0.000148 

0.000067 

0.000017 

energyDensities 

1.250 

0.000000 

0.000323 

0.000452 

0.000595 

0.001357 

0.001486 

0.001597 

0.001795 

0.001754 

0.001688 

0.001062 

0.000904 

0.000747 

0.000121 

0.000055 

0.000014 

energyDensities 

1.300 

0.000000 

0.000267 

0.000374 

0.000492 

0.001121 

0.001227 

0.001319 

0.001483 

0.001449 

0.001394 

0.000877 

0.000747 

0.000617 

0.000100 

0.000045 

0.000011 

energyDensities 

1.350 

0.000000 

0.000222 

0.000311 

0.000409 

0.000932 

0.001020 

0.001097 

0.001233 

0.001205 

0.001159 

0.000729 

0.000621 

0.000513 

006223 

0.006468 

0.006619 

0.006669 

005889 

0.005478 

0.005002 

0 . 004475 

002194 

000000 

0.001667 

0.001191 

0.000780 

000040 

0.000159 

0.000352 

0.000615 

002173 

0.002629 

0.003086 

0.003528 

004906 

0.005100 

0.005219 

0.005258 

004643 

0.004319 

0.003944 

0.003528 

001730 

000000 

0.001315 

0.000939 

0.000615 

000032 

0.000126 

0.000280 

0 . 000489 

001727 

0.002090 

0.002453 

0.002805 

003901 

0.004055 

0.004149 

0.004181 

003692 

0.003434 

0.003136 

0.002805 

001375 

000000 

0.001045 

0.000747 

0 . 000489 

000025 

0.000101 

0.000225 

0.000392 

001385 

0.001676 

0.001967 

0.002249 

003127 

0.003250 

0.003326 

0.003352 

002959 

0.002753 

0.002514 

0.002249 

001103 

000000 

0.000838 

0.000599 

0.000392 

000021 

0.000082 

0.000181 

0.000317 

001119 

0.001354 

0.001589 

0.001817 

002527 

0.002627 

0.002688 

0.002708 

002391 

0.002225 

0.002031 

0.001817 

000891 

000000 

0.000677 

0 . 000484 

0.000317 

000017 

0.000067 

0.000148 

0.000258 

000911 

0.001103 

0.001294 

0.001480 

002058 

0.002139 

0.002189 

0.002205 

001947 

0.001811 

0.001654 

0.001480 

000726 

000000 

0.000551 

0.000394 

0.000258 

000014 

0.000055 

0.000121 

0.000212 

000747 

0.000904 

0.001062 

0.001214 

001688 

0.001754 

0.001795 

0.001809 

001597 

0.001486 

0.001357 

0.001214 

000595 

000000 

0.000452 

0.000323 

0.000212 

000011 

0.000045 

0.000100 

0.000175 

000617 

0.000747 

0.000877 

0.001003 

001394 

0.001449 

0.001483 

0.001494 

001319 

0.001227 

0.001121 

0.001003 

000492 

000000 

0.000374 

0.000267 

0.000175 

000009 

0.000037 

0.000083 

0.000145 

000513 

0.000621 

0.000729 

0 . 000834 

001159 

0.001205 

0.001233 

0.001242 

001097 

0.001020 

0.000932 

0.000834 

000409 

0.000311 

0.000222 

0.000145 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 
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0 

0 
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0 

0 

0 

0 

0 
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0 

0 
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0.000083 

0.000037 

0.000009 

energyDensities 

1.400 

0.000000 

0.000186 

0.000260 

0.000342 

0.000779 

0.000854 

0.000918 

0.001031 

0.001008 

0.000970 

0.000610 

0.000520 

0.000429 

0.000070 

0.000031 

0.000008 

energyDensities 

1.450 

0.000000 

0.000156 

0.000219 

0.000288 

0.000656 

0.000718 

0.000772 

0.000868 

0.000848 

0.000816 

0.000513 

0.000437 

0.000361 

0.000059 

0.000026 

0.000007 

energyDensities 

1.500 

0.000000 

0.000132 

0.000185 

0.000243 

0.000555 

0.000608 

0.000653 

0.000734 

0.000718 

0.000690 

0.000434 

0.000370 

0.000306 

0.000050 

0.000022 

0.000006 

energyDensities 

1.550 

0.000000 

0.000112 

0.000157 

0.000207 

0.000472 

0.000517 

0.000556 

0.000624 

0.000610 

0.000587 

0.000369 

0.000315 

0.000260 

0.000042 

0.000019 

0.000005 

energyDensities 

1.600 

0.000000 

0.000096 

0.000134 

0.000177 

0.000403 

0.000442 

0.000475 

0.000534 

0.000522 

0.000502 

0.000316 

0.000269 

0.000222 

0.000036 

0.000016 

0.000004 

energyDensities 

1.650 

0.000000 

0.000082 

0.000115 

0.000152 

0.000346 

0.000379 

0.000408 

0.000458 

0.000448 

0.000431 

0.000271 

0.000231 

0.000191 

0.000031 

0.000014 

0.000004 

energyDensities 

1.700 

0.000000 

0.000071 

0.000100 

0.000131 

0.000299 

0.000327 

0.000352 

0.000395 

0.000386 

0.000372 

0.000234 

0.000199 

0.000165 

0.000027 

0.000012 

0.000003 

energyDensities 

1.750 

0.000000 

0.000062 

0.000086 

0.000113 

0.000259 

0.000283 

0.000305 

0.000342 

0.000334 

0.000322 

0.000202 

0.000172 

0.000142 

0.000023 

0.000010 

0.000003 

energyDensities 

1.800 

0.000000 

0.000054 

0.000075 

0.000099 

000000 

000008 

0.000031 

0.000070 

0.000122 

000429 

0.000520 

0.000610 

0.000697 

000970 

0.001008 

0.001031 

0.001039 

000918 

0.000854 

0.000779 

0.000697 

000342 

0.000260 

0.000186 

0.000122 

000000 

000007 

0.000026 

0.000059 

0.000102 

000361 

0.000437 

0.000513 

0.000587 

000816 

0.000848 

0.000868 

0.000874 

000772 

0.000718 

0.000656 

0.000587 

000288 

0.000219 

0.000156 

0.000102 

000000 

000006 

0.000022 

0.000050 

0.000087 

000306 

0.000370 

0 . 000434 

0.000496 

000690 

0.000718 

0.000734 

0.000740 

000653 

0.000608 

0.000555 

0.000496 

000243 

0.000185 

0.000132 

0.000087 

000000 

000005 

0.000019 

0.000042 

0.000074 

000260 

0.000315 

0.000369 

0.000422 

000587 

0.000610 

0.000624 

0.000629 

000556 

0.000517 

0.000472 

0.000422 

000207 

0.000157 

0.000112 

0.000074 

000000 

000004 

0.000016 

0.000036 

0.000063 

000222 

0.000269 

0.000316 

0.000361 

000502 

0.000522 

0.000534 

0.000538 

000475 

0.000442 

0.000403 

0.000361 

000177 

0.000134 

0.000096 

0.000063 

000000 

000004 

0.000014 

0.000031 

0.000054 

000191 

0.000231 

0.000271 

0.000310 

000431 

0.000448 

0.000458 

0.000462 

000408 

0.000379 

0.000346 

0.000310 

000152 

0.000115 

0.000082 

0.000054 

000000 

000003 

0.000012 

0.000027 

0.000047 

000165 

0.000199 

0.000234 

0.000267 

000372 

0.000386 

0.000395 

0.000398 

000352 

0.000327 

0.000299 

0.000267 

000131 

0.000100 

0.000071 

0.000047 

000000 

000003 

0.000010 

0.000023 

0.000040 

000142 

0.000172 

0.000202 

0.000231 

000322 

0.000334 

0.000342 

0.000345 

000305 

0.000283 

0.000259 

0.000231 

000113 

0.000086 

0.000062 

0.000040 

000000 

000002 

0.000009 

0.000020 

0.000035 

000124 

0.000150 

0.000176 

0.000201 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 
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0.000225 

0.000246 

0.000265 

0.000298 

0.000291 

0.000280 

0.000176 

0.000150 

0.000124 

0.000020 

0.000009 

0.000002 

energyDensities 

1.850 

0.000000 

0.000047 

0.000065 

0.000086 

0.000196 

0.000215 

0.000231 

0.000260 

0.000254 

0.000244 

0.000154 

0.000131 

0.000108 

0.000018 

0.000008 

0.000002 

energyDensities 

1.900 

0.000000 

0.000041 

0.000057 

0.000075 

0.000172 

0.000188 

0.000202 

0.000227 

0.000222 

0.000214 

0.000134 

0.000115 

0.000095 

0.000015 

0.000007 

0.000002 

energyDensities 

1.950 

0.000000 

0.000036 

0.000050 

0.000066 

0.000151 

0.000165 

0.000178 

0.000200 

0.000195 

0.000188 

0.000118 

0.000101 

0.000083 

0.000013 

0.000006 

0.000002 

energyDensities 

2.000 

0.000000 

0.000032 

0.000044 

0.000058 

0.000133 

0.000146 

0.000157 

0.000176 

0.000172 

0.000166 

0.000104 

0.000089 

0.000073 

0.000012 

0.000005 

0.000001 

end  inputDirSpectrum 


000280 

0.000291 

0.000298 

0.000300 

000265 

0.000246 

0.000225 

0.000201 

000099 

000000 

0.000075 

0.000054 

0.000035 

000002 

0.000008 

0.000018 

0.000031 

000108 

0.000131 

0.000154 

0.000176 

000244 

0.000254 

0.000260 

0.000262 

000231 

0.000215 

0.000196 

0.000176 

000086 

000000 

0.000065 

0.000047 

0.000031 

000002 

0.000007 

0.000015 

0.000027 

000095 

0.000115 

0.000134 

0.000154 

000214 

0.000222 

0.000227 

0.000229 

000202 

0.000188 

0.000172 

0.000154 

000075 

000000 

0.000057 

0.000041 

0.000027 

000002 

0.000006 

0.000013 

0.000024 

000083 

0.000101 

0.000118 

0.000135 

000188 

0.000195 

0.000200 

0.000201 

000178 

0.000165 

0.000151 

0.000135 

000066 

000000 

0.000050 

0.000036 

0.000024 

000001 

0.000005 

0.000012 

0.000021 

000073 

0.000089 

0.000104 

0.000119 

000166 

0.000172 

0.000176 

0.000178 

000157 

0.000146 

0.000133 

0.000119 

000058 

000000 

0.000044 

0.000032 

0.000021 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 
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0 

0 

0 
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A.4  Sample  Input  File  for  SM3DBuildSeaway3 

begin  SM3DBuildSeaway3 

label  Hs  =  3.25  m,  Tp  =  9.7  s,  Bretschneider  spectrum 

seawayFileName  bretSeaState5Seaway . xml 

waterDensity  1025 

sampleParams  3600  0.1 

seawayOption  UniSpectrum 

begin  uniSpectrumSeaway 

waveFreqRange  0.2  2  0.05  randomlnc  2001 
phaseSeed  1001 
deleteRelThreshEnergy  IE-06 
waveHeading  0 

uniSpectrumOption  Bretschneider 
BretParam  3.25  9.7 
end  uniSpectrumSeaway 
end  SM3DBuildSeaway3 
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A.5  Sample  Output  File  for  SM3DBuildSeaway3 

Program  SM3DBuildSeaway 

ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Time  :  November-09-11  8:20:46  AM 
Run  label : 

Hs  =  3.25  m,  Tp  =  9.7  s,  Bretschneider  spectrum 
****  ECHO  OF  USER  INPUT  **** 

Wave  heading  convention  is  0  deg  for  waves  from  north,  90  deg  from  east 
Phase  convention  is  lead  of  crest  at  origin  xf=0,  yf=0 

Output  seaway  file  name: 
bretSeaState5Seaway . xml 

Water  density  :  1025.000  kg/m3 

Parameters  for  sampling  of  seaway  statistics  (input) 

Duration  :  3600.000  s 
Interval  :  0.100  s 

Seaway  type  :  UniSpectrum 

Seaway  from  uni-directional  wave  spectrum 
Minimum  wave  frequency  :  0.200  rad/s 

Maximum  wave  frequency  :  2.000  rad/s 

Wave  frequency  increment  :  0.050  rad/s 

Option  for  random  adjustment  of  wave  frequency  increment:  Randomlnc 
Seed  number  for  random  adjustment  of  wave  freq  increment:  2001 
Wave  component  phase  seed  numbers:  1001  (input) 

User  input  threshold  for  relative  energy  :  IE-06 
Wave  heading  0.000  deg  (from) 

Unidirectional  spectrum  option  :  Bretschneider 
Parameters  for  unidirectional  Bretschneider  spectrum 
Significant  wave  height  3.250  m 

Peak  wave  period  9.700  s 

Plot  output  option  :  File 

****  PROPERTIES  OF  MULTI-COMPONENT  SEAWAY  **** 

Multi-component  seaway  in  earth-fixed  axes 

Significant  wave  height  assuming  random  phases  :  3.234  m 
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Wave  component 

properties 

Heading 

Frequency 

Amplitude 

Phase 

(deg) 

(rad/s) 

(m) 

(deg) 

0.000 

0.349345 

0.002402 

198.511 

0.000 

0.418409 

0.055160 

70.582 

0.000 

0.437714 

0.094406 

81.966 

0.000 

0.517538 

0.291281 

154.988 

0.000 

0 . 554448 

0.306792 

158.412 

0.000 

0.604834 

0.386297 

8.321 

0.000 

0.662306 

0.365597 

156.378 

0.000 

0.697024 

0.316578 

70.481 

0.000 

0.734546 

0.375214 

297.382 

0.000 

0.807591 

0.342888 

127.010 

0.000 

0.851395 

0.264564 

88.077 

0.000 

0.889681 

0.241294 

80.367 

0.000 

0.930918 

0.254865 

227.058 

0.000 

0.994664 

0.230586 

220.868 

0.000 

1.042700 

0.188533 

197.976 

0.000 

1.085678 

0.181435 

208.965 

0.000 

1 . 143028 

0.163821 

258.803 

0.000 

1 . 188408 

0.163712 

307.284 

0.000 

1.265374 

0.144852 

183.054 

0.000 

1.316318 

0.099871 

14.807 

0.000 

1.338522 

0.106165 

59.607 

0.000 

1.405762 

0.112056 

175.743 

0.000 

1.464295 

0.082318 

312.384 

0.000 

1.488291 

0.085054 

331.497 

0.000 

1.559574 

0.081297 

209.033 

0.000 

1.597439 

0.072998 

39.277 

0.000 

1.658453 

0 . 073645 

323.848 

0.000 

1.718254 

0.058012 

147.980 

0.000 

1.747604 

0.055811 

333.016 

0.000 

1.807912 

0.057250 

169.246 

0.000 

1.859051 

0.048903 

354.382 

0.000 

1.901196 

0 . 043427 

45.827 

0.000 

1.941211 

0.045237 

197.320 

0.000 

2.000000 

0.032415 

353.648 

****  Wave  elevation  time 
Mean 

Standard  deviation 

Minimum 

Maximum 

Zero-crossing  period 


series  statistics  **** 
-0.001  m 
0.807  m 
-3.010  m 
2 . 632  m 
7.364  s 
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Significant  wave  height  based  on  RMS  wave  elevation  : 


3.234  m 


Computation  time  :  0  s 
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Annex  B:  Files  for  Simulating  Motions  of 
Freely  Maneuvering  Ship  with 
SM3DFreeMo3 

B.1  Format  of  Input  File  for  Simulating  Motion  of  a 
Freely  Maneuvering  Ship  with  SM3DFreeMo3 

Record  (1),  Beginning  Record 

“begin  SM3DFreeMo3”  (1  character  string  with  2  words) 

Record  (2),  Run  Label 

“label” ,  label  (2  character  strings) 

“label”  Record  tag. 

label  Label  for  run.  This  can  include  spaces. 

Record  (3),  Beginning  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

“begin  note”  (1  character  string  with  2  words) 

Record  (3a),  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

noteText  (character  string) 

noteText  Text  of  note.  Multiple  lines  can  be  entered. 

Record  (3b),  End  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

“end  note”  (1  character  string  with  2  words) 
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Record  (4),  Input  Ship  Database  File  Name 

“shipDBFileName” ,  (2  character  strings) 

“shipDBFileName”  Record  tag. 

shipDBFileName  Name  of  input  ship  database  hie  in  .NET  binary 

serialization  format.  This  hie  must  have  been  created  using 
program  SM3DBuildShip3. 


Record  (5),  Length  Data 

“lengthData” ,  lpp,  stationAP  (1  character  string,  2  boats) 

“lengthData”  Record  tag. 

lpp  Ship  length  between  perpendiculars  (m) 

stationAP  Station  number  of  the  aft  perpendicular.  This  value  is  typically 


20.0 


Note:  The  values  in  this  record  must  agree  with  the  values  used  for  the 

ship  database  hie  specihed  in  Record  (4).  Values  are  considered 
to  be  in  agreement  when  they  are  within  a  tolerance  of  0.001  m 
for  length,  and  0.001  for  the  station  of  the  aft  perpendicular.  The 
output  hie  from  SM3DBuildShip3  gives  the  values  of  the  above 
parameters. 
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Record  (6),  Ship  Loading  Condition 

“loadCondition” ,  waterDensity,  draftBIMid,  trimBIStern,  shipKG,  correctionGM 
(1  character  string,  5  floats) 


“loadCondition” 

waterDensity 

draftBIMid 

trimBIStern 

shipKG 

correctionGM 


Record  tag. 

Water  density  (kg/m3). 

Draft  of  baseline  at  midships  (m). 

Trim  of  baseline  by  stern  (m). 

Height  of  centre  of  gravity  above  baseline  (m). 
Correction  to  metacentric  height  (m). 


Note:  The  values  in  this  record  must  agree  with  the  values  used  for 

the  ship  database  file  specified  in  Record  (4).  Values  are 
considered  to  be  in  agreement  when  they  are  within  a  tolerance 
of  0.001  kg/m3  for  density,  and  0.001  m  for  draft,  trim,  height 
of  CG,  and  metacentric  height.  The  output  file  from 
SM3DBuildShip3  gives  the  values  of  the  above  parameters. 


Record  (7),  Beginning  of  Rudder  Autopilot  Settings 

“begin  rudderAutopilotSettings”  (2  character  strings) 

Records  (7)  to  (7g)  are  optional. 

“begin  rudderAutopilotSettings”  Record  tag. 

Note:  Records  (7)  to  (7g)  are  optional  and  can  be 

used  to  supersede  autopilot  settings  for  a  ship 
defined  by  SM3DBuildShip3  given  in  the  file  of 
Record  (4).  Within  Records  (7)  to  (7g), 
Records  (7a)  to  (7f)  can  be  repeated  an 
arbitrary  number  of  times  to  set  rudder 
autopilot  parameters  as  required. 
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Record  (7a),  Rudder  Key  for  Autopilot  Settings 

“keyRudder”  keyRudder  (2  character  strings) 

This  Record  must  follow  Record  (7)  if  autopilot  settings  are  being  given  as  input. 
“keyRudder”  Record  tag. 

keyRudder  Key  of  rudder  for  which  autopilot  settings  are  being  specified.  If 
the  rudder  key  is  set  to  “All” ,  then  the  input  autopilot  settings 
are  applied  to  all  rudders. 


Record  (7b),  Rudder  Autopilot  Control  Parameters 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a) 

“controlParam” ,  deflectMaxDeg,  velMaxDeg,  accMaxDeg,  freqResponse, 
dampResponse,  dtMax  (1  character  string,  6  floats) 


“controlParam”  Record  tag. 

deflectMaxDeg  Maximum  rudder  deflection  angle  (deg).  This  value  is  typically 
set  to  35°. 


velMaxDeg 


accMaxDeg 


freqResponse 


Maximum  rudder  deflection  velocity  (deg/s).  If  this  value  is  set 
to  0.0,  then  the  maximum  velocity  is  unlimited. 

Maximum  rudder  acceleration  (deg/s2).  If  this  value  is  set  to 
0.0,  then  the  maximum  acceleration  is  unlimited. 

Undamped  response  frequency  of  rudder  autopilot. 


dampResponse  Damping  of  rudder  autopilot  as  a  fraction  of  critical  damping. 
This  value  is  typically  between  0.5  and  1.0 


dtMax  Maximum  time  increment  for  time  stepping  of  rudder  motions. 

If  this  value  is  set  to  0.0,  then  no  limit  is  applied  and  time 
stepping  is  done  using  the  same  time  increment  as  for  ship 
motions. 


Note: 


If  this  record  is  not  included  after  Record  (7a),  then  the 
original  values  for  the  given  ship  rudder  autopilot  are  used. 
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Record  (Tc),  Rudder  Autopilot  Displacement  Gains 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a) 

“dispGains”,  surgeGain,  swayGain,  heaveGain,  rollGain,  pitchGain,  yawGain  (1 
character  string,  6  floats) 

“dispGains”  Record  tag. 


surgeGain 

Surge  gain  (deg/m).  This  value  should  be  0.0. 

swayGain 

Sway  gain  (deg/m).  This  value  should  be  0.0. 

heaveGain 

Heave  gain  (deg/m).  This  value  is  typically  0.0. 

rollGain 

Roll  gain  (deg/deg).  This  value  is  typically  0.0  unless  rudder  roll 
stabilization  is  desired. 

pitchGain 

Pitch  gain  (deg/deg).  This  value  is  typically  0.0. 

yawGain 

Yaw  gain  (deg/deg).  Note  that  input  yaw  gain  is  defined  according 
to  ship  motions  in  earth-fixed  axes,  for  which  positive  yaw  motion 
is  clockwise.  For  a  typical  ship  with  a  downward  oriented  rudder, 
this  value  is  typically  <  0.0. 

Note: 

If  this  record  is  not  included  after  Record  (7a),  then  the  original 
values  for  the  given  ship  rudder  autopilot  are  used. 

DRDC  Atlantic  TM  2011-308 


79 


Record  (7d),  Rudder  Velocity  Gains 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a). 

“velGains”,  surge VelGain,  swayVelGain,  heave VelGain,  rollVelGain, 
pitchVelGain,  yaw  VelGain  (1  character  string,  6  floats) 

“velGains”  Record  tag. 


surge  VelGain 

Surge  velocity  gain  (deg/ (m/s)).  This  value  should  be  0.0. 

swayVelGain 

Sway  velocity  gain  (deg/ (m/s)).  This  value  should  be  0.0. 

heave  VelGain 

Heave  velocity  gain  (deg/ (m/s)).  This  value  is  typically  0.0. 

rollVelGain 

Roll  velocity  gain  (deg/ (deg/s)).  This  value  is  typically  0.0  unless 
rudder  stabilization  is  desired. 

pitchVelGain 

Pitch  velocity  gain  (deg/ (deg/s)).  This  value  is  typically  0.0. 

yawVelGain 

Yaw  velocity  gain  (deg/(deg/s)).  Note  that  input  yaw  gain  is 
defined  according  to  ship  motions  in  earth-fixed  axes,  for  which 
positive  yaw  motion  is  clockwise.  For  a  typical  ship  with  a 
downward  oriented  rudder,  this  value  is  typically  <  0.0. 

Note: 

If  this  record  is  not  included  after  Record  (7a),  then  the  original 
values  for  the  given  ship  rudder  autopilot  are  used. 
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Record  (7e),  Rudder  Integral  Gains 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a) 

“intGains”,  surgelntGain,  swaylntGain,  heavelntGain,  rollIntGain,  pitchlntGain, 
yawIntGain  (1  character  string,  6  floats) 

“intGains”  Record  tag. 

surgelntGain  Surge  integral  gain  (deg/(m-s)).  This  value  should  be  0.0. 

swaylntGain  Sway  integral  gain  (deg/(m-s)).  This  value  should  be  0.0. 

heavelntGain  Heave  integral  gain  (deg/(m-s)).  This  value  is  typically  0.0. 

rollIntGain  Roll  integral  gain  (deg/(deg-s)).  This  value  is  typically  0.0  unless 
rudder  stabilization  is  desired. 

Pitch  integral  gain  (deg/(deg-s)).  This  value  is  typically  0.0. 

Yaw  integral  gain  (deg/(deg-s)).  For  a  typical  ship  with  a 
downward  oriented  rudder,  this  value  is  typically  <  0.0. 

If  this  record  is  not  included  after  Record  (7a),  then  the  original 
values  for  the  given  ship  rudder  autopilot  are  used. 


pitchlntGain 

yawIntGain 

Note: 


Record  (7f),  Rudder  Autopilot  Integration  Time 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a) 

“integrationTime” ,  integrationTime  (1  character  string,  1  float) 

“integrationTime”  Record  tag. 

integrationTime  Integration  time  for  rudder  autopilot  (s). 

Note:  If  this  record  is  not  included  after  Record  (7a),  then  the 

original  value  for  the  given  ship  rudder  autopilot  is  used. 


Record  (7g),  End  of  Rudder  Autopilot  Settings 

This  record  is  required  if  Record  (7)  has  been  included, 
“end  rudderAutopilotSettings”  (2  character  strings) 
“end  rudderAutopilotSettings”  Record  tag. 
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Record  (8),  Beginning  of  Azimuthing  Propeller  Deflection  Controller 
Settings 

“begin  aziPropellerDeflectControllcrSettings”  (2  character  strings) 

Records  (8)  to  (8g)  are  optional. 

“begin  aziPropellerDeflectControllerSettings”  Record  tag. 


Note: 


Records  (8)  to  (8g)  are  optional 
and  can  be  used  to  supersede 
autopilot  settings  for  a  ship 
defined  by  SM3DBuildShip3  given 
in  the  hie  of  Record  (4).  Within 
Records  (8)  to  (8g),  Records  (8a) 
to  (8f)  can  be  repeated  an 
arbitrary  number  of  times  to  set 
azimuthing  propeller  controller 
parameters  as  required. 


Record  (8a),  Azimuthing  Propeller  Key  for  Controller  Settings 

This  record  must  follow  Record  (8)  if  controller  settings  are  being  given  as  input. 
“keyAziPropeller”  keyAziPropeller  (1  character  string,  1  integer) 

Record  tag. 


“keyAziPropeller1 
keyAziProp  cller 


Key  of  azimuthing  propeller  for  which  controller  settings  are 
being  specified.  If  this  key  to  set  to  “AH” ,  then  the  input 
controller  settings  are  applied  to  all  azimuthing  propeller. 
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Record  (8b),  Azimuthing  Propeller  Deflection  Response  Parameters 

This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (8a). 

“deflect ControlParam” ,  deflectMaxDeg,  deflect VelMaxDeg,  deflectAccMaxDeg, 
deflectFreqResponse,  deflectDampResponse,  dtMax  (1  character  string,  6  floats) 

“deflect ControlParam”  Record  tag. 


deflectMaxDeg 

Maximum  deflection  angle  (deg).  This  value  is  typically 
set  to  35°. 

deflect  VelMaxDeg 

Maximum  deflection  velocity  (deg/s).  If  this  value  is  set 
to  0.0,  then  the  maximum  velocity  is  unlimited. 

deflectAccMaxDeg 

Maximum  deflection  acceleration  (deg/s2).  If  this  value 
is  set  to  0.0,  then  the  maximum  acceleration  is 
unlimited. 

deflectFreqResponse 

Undamped  response  frequency  of  deflection  controller. 

deflectDampResponse 

Damping  of  deflection  controller  as  a  fraction  of  critical 
damping.  This  value  is  typically  between  0.5  and  1.0. 

deflectDtMax 

Maximum  time  increment  for  time  stepping  of 
azimuthing  propeller  deflections.  If  this  value  is  set  to 
0.0,  then  no  limit  is  applied  and  time  stepping  is  done 
using  the  same  time  increment  as  for  ship  motions. 

Note: 

If  this  record  is  not  included  after  Record  (8a),  then  the 
original  values  for  the  given  azimuthing  propeller 
controller  are  used. 
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Record  (8c),  Azimuthing  Propeller  Deflection  Controller  Displacement 
Gains 


This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (8a). 

“deflectDispGains” ,  surgeGain,  swayGain,  heaveGain,  rollGain,  pitchGain, 
yawGain  (1  character  string,  6  floats) 

“deflectDispGains”  Record  tag. 


surgeGain 

Surge  gain  (deg/m).  This  value  should  be  0.0. 

swayGain 

Sway  gain  (deg/m).  This  value  should  be  0.0. 

heaveGain 

Heave  gain  (deg/m).  This  value  is  typically  0.0. 

rollGain 

Roll  gain  (deg/deg).  This  value  is  typically  0.0  unless  roll 
stabilization  is  desired. 

pitchGain 

Pitch  gain  (deg/deg).  This  value  is  typically  0.0. 

yawGain 

Yaw  gain  (deg/deg).  For  a  ship  with  using  a  downward 
oriented  azimuthing  propeller  for  course  keeping,  this  value 
is  typically  <0.0. 

Note: 

If  this  record  is  not  included  after  Record  (8a),  then  the 
original  values  for  the  given  azimuthing  propeller  controller 
are  used. 
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Record  (8d),  Azimuthing  Propeller  Deflection  Controller  Velocity  Gains 

This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (8a). 

“deflect VelGains” ,  surge  VelGain,  swayVelGain,  heave VelGain,  rollVelGain, 
pitchVelGain,  yaw  VelGain  (1  character  string,  6  floats) 


“deflect  VelGains” 

Record  tag. 

surge  VelGain 

Surge  velocity  gain  (deg/ (m/s)). 

This  value  should  be  0.0. 

swayVelGain 

Sway  velocity  gain  (deg/ (m/s)). 

This  value  should  be  0.0. 

heave  VelGain 

Heave  velocity  gain  (deg/ (m/s)). 

This  value  is  typically  0.0. 

rollVelGain 

Roll  velocity  gain  (deg/ (deg/s)), 
unless  stabilization  is  desired. 

This  value  is  typically  0.0 

pitchVelGain 

Pitch  velocity  gain  (deg/ (deg/s)) 

.  This  value  is  typically  0.0 

yawVelGain 

Yaw  velocity  gain  (deg/ (deg/s)).  For  a  ship  with  using  a 
downward  oriented  azimuthing  propeller  for  course  keeping, 
this  value  is  typically  <  0.0. 

Note: 

If  this  record  is  not  included  after  Record  (8a),  then  the 
original  values  for  the  given  azimuthing  propeller  controller 
are  used. 
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Record  (8e),  Azimuthing  Propeller  Deflection  Controller  Integral  Gains 

This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (8a). 

“deflectlntGains”,  surgelntGain,  swaylntGain,  heavelntGain,  rollIntGain, 
pitchlntGain,  yawIntGain  (1  character  string,  6  floats) 


“deflectlntGains” 

surgelntGain 

swaylntGain 

heavelntGain 

rollIntGain 


Record  tag. 

Surge  integral  gain  (deg/(m-s)).  This  value  should  be  0.0. 

Sway  integral  gain  (deg/(m-s)).  This  value  should  be  0.0. 

Heave  integral  gain  (deg/(m-s)).  This  value  is  typically  0.0 

Roll  integral  gain  (deg/(deg-s)).  This  value  is  typically  0.0 
unless  rudder  stabilization  is  desired. 


pitchlntGain 

yawIntGain 


Note: 


Pitch  integral  gain  (deg/(deg-s)).  This  value  is  typically  0.0. 

Yaw  integral  gain  (deg/(deg-s)).  For  a  ship  with  using  a 
downward  oriented  azimuthing  propeller  for  course  keeping, 
this  value  is  typically  <0.0. 

If  this  record  is  not  included  after  Record  (8a),  then  the 
original  values  for  the  given  azimuthing  propeller  controller 
are  used. 


Record  (8f),  Azimuthing  Propeller  Deflection  Controller  Integration 
Time 

This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (8a). 

“deflectlntegrationTime”,  deflect Integr at ionTime  (1  character  string,  1  float) 
“deflectlntegrationTime”  Record  tag. 

deflectlntegrationTime  Integration  time  for  deflection  controller  (s). 

Note:  If  this  record  is  not  included  after  Record  (8a),  then 

the  original  values  for  the  given  azimuthing  propeller 
controller  are  used. 


Record  (8g),  End  of  Azimuthing  Propeller  Controller  Settings 

This  record  is  required  if  Record  (8)  has  been  included 

“end  aziPropcllerDeflectControllerSettings”  (2  character  strings) 
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Record  (9),  Output  Motion  Time  Series  File  Name 

“timeSeriesFileName” ,  timeSeriesFilcName  (2  character  strings) 
“timeSeriesFileName”  Record  tag. 

timeSeriesFileName  Name  of  output  ship  motion  time  series  in  .NET  binary 

serialization  format. 

Record  (10),  Seaway  Calm  Option 

“seawayCalmOption” ,  seawayCalmOption  (2  character  strings) 
“seawayCalmOption”  Record  tag. 

seawayCalmOption  Option  for  seaway  or  calm  water. 

Seaway  -  The  simulation  includes  a  seaway  with  waves. 
Calm  -  The  simulation  is  in  calm  water. 

Record  (11),  Input  Seaway  File  Name 

This  record  should  only  be  given  if  seawayOption  in  Record  (10)  is  set  to  Seaway. 
“seawayFileName”,  seaway FileName  (2  character  strings) 

“seawayFileName”  Record  tag. 

seawayFileName  Name  of  input  seaway  hie  in  .NET  XML  serialization 

format.  This  hie  must  have  been  created  using  program 
SM3DBuildSeaway3. 
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Record  (12),  Time  Parameters 

“timeParameters” ,  dtMax,  tO,  tEndRampWave,  tBeginStats  (1  character  string, 

4  floats) 

“timeParameters”  Record  tag. 

dtMax  Time  step  for  motion  computations  (s).  A  suitable  time  step 

value  depends  mainly  on  the  size  of  the  ship,  and  to  a  lesser 
extent  on  the  encountered  conditions.  A  value  of  0.2  s  has 
been  shown  to  give  reliable  results  for  a  naval  frigate. 

tO  Start  time  of  simulation. 


tEndRampWave  End  time  for  reducing  wave  excitation  forces  (s).  If 

tEndRampWave  is  greater  than  tO,  then  a  ramp  function 
increasing  from  0.0  at  tO  to  1.0  at  tEndRampWave  will  be 
applied  to  wave  excitation  forces.  This  feature  can  be  used  to 
reduce  transients  at  the  beginning  of  a  simulation. 

tBeginStats  Beginning  time  for  sampling  motion  statistics  (s). 


Record  (13),  Nonlinear  Option  for  Buoyancy  and  Incident  (Froude- 
Krylov)  Wave  Forces 

“hullForceNonLinearOption” ,  hullForceNonLinearOption  (2  character  strings) 
“hullForceNonLinearOption”  Record  tag. 

hullForceNonLinearOption  Option  for  using  nonlinear  computations  of  forces 

due  to  incident  waves  and  buoyancy. 

Buoylncident  -  Nonlinear  computation  of  forces 
due  to  incident  waves  and  buoyancy.  If  this  option 
is  used,  then  the  ship  file  produced  by 
SM3DBuildShip3  and  specified  in  Record  (4)  must 
include  a  dry  panelled  hull. 

Linear  -  Linear  computation  of  forces  due  to 
incident  waves  and  buoyancy. 


88 


DRDC  Atlantic  TM  2011-308 


Record  (14),  Initial  Ship  Position 

“dispsFixedOMDeg”,  dispsFixedOMDeg  (1  character  string,  6  floats) 
“dispsFixedOMDeg”  Record  tag. 

dispsFixedOMDeg  Initial  ship  position  in  earth-fixed  coordinates: 

x *  of  ship  CG  (m,  +  north). 
yl  of  ship  CG  (m,  +  west). 

Heave  773  of  ship  CG  relative  to  calm  water  position  (nr,  + 

up). 

Roll  774  (deg,  +  port  up). 

Pitch  775  (deg,  +  bow  down). 

Ship  heading  x  (deg,  0°  for  north,  90°  for  east). 

Record  (15a),  Initial  Ship  Speed 

The  input  file  must  include  one  of  Records  (15a),  (15b),  or  (15c). 

“speedO”,  speedO  (1  character  string,  1  float) 

“speedO”  Record  tag. 

speedO  Initial  ship  speed  along  the  heading  given  in  Record  (14)  (m/s). 

Record  (15b),  Initial  Ship  Speed  in  Knots 

The  input  file  must  include  one  of  Records  (15a),  (15b),  or  (15c). 

“speedOKnots” ,  speedOKnots  (1  character  string,  1  float) 

“speedOKnots”  Record  tag. 

speedOKnots  Initial  ship  speed  along  the  heading  given  in  Record  (14) 
(knots). 
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Record  (15c),  Initial  Ship  Velocity  for  Six  Degrees  of  Freedom 

The  input  file  must  include  one  of  Records  (15a),  (15b),  or  (15c). 
“velsFixedOMDeg”,  velsFixedOMDeg  (1  character  string,  6  floats) 
“velsFixedOMDeg”  Record  tag. 

velsFixedOMDeg  Initial  ship  velocity  in  earth-fixed  coordinates: 

x?  of  ship  CG  (m/s,  +  north). 

yf  of  ship  CG  (m/s,  +  west). 

Heave  velocity  rj 3  of  ship  CG  (m/s,  +  up). 

Roll  velocity  ^4  (deg/s,  +  port  up). 

Pitch  velocity  r]5  (deg/s,  +  bow  down). 

Ship  heading  velocity  x  (deg/s,  +  clockwise  viewed  from 
above). 

Record  (16),  Initial  Rudder  Deflections 

This  record  is  optional. 

“rudderDeflectsODeg” ,  rudderDeflectsODeg  (1  character  string,  nRudder  floats) 
“rudderDeflectsODeg”  Record  tag. 

rudderDeflectsODeg  Initial  rudder  deflections  (deg,  +  counter-clockwise 

viewed  from  inside  hull).  If  this  record  is  not  given,  then 
defaults  of  0°  are  used.  If  this  record  is  given,  then  the 
number  of  values  should  correspond  with  the  number  of 
rudders  in  the  ship  file  specified  by  Record  (4). 

Record  (IT),  Initial  Rudder  Velocities 

This  record  is  optional. 

“rudder VelsODeg” ,  rudder VelsODeg  (1  character  string,  nRudder  floats) 

“rudder VelsODeg”  Record  tag. 

rudder  VelsODeg  Initial  rudder  velocities  (deg/s,  +  counter-clockwise  viewed 

from  inside  hull).  If  this  record  is  not  given,  then  defaults  of 
0  deg/s  are  used.  If  this  record  is  given,  then  the  number  of 
values  should  correspond  with  the  number  of  rudders  in  the 
ship  file  specified  by  Record  (4). 
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Record  (18),  Initial  Propeller  RPMs 

This  record  is  optional. 

“rpmsPropellersO” ,  rpmsPropcllcrsO  (1  character  string,  nPropcller  floats) 
“rpmsPropellcrsO”  Record  tag. 

rpmsPropellersO  Initial  propeller  RPM  values.  If  this  record  is  not  given,  then 
defaults  of  0  RPM  are  used.  If  this  record  is  given,  then  the 
number  of  values  should  correspond  with  the  number  of 
propellers  in  the  ship  file  specified  by  Record  (4). 

Record  (19),  Initial  Azimuthing  Propeller  Deflections 

This  record  is  optional. 

“aziPropellerDeflectsODeg” ,  aziPropellerDeflectsODeg  (1  character  string, 
nAziPropellcr  floats) 

“aziPropellerDeflectsODeg”  Record  tag. 

aziPropellerDeflectsODeg  Initial  azimuthing  propeller  deflections  (deg,  + 

counter-clockwise  viewed  from  inside  hull).  If  this 
record  is  not  given,  then  defaults  of  0°  are  used.  If 
this  record  is  given,  then  the  number  of  values 
should  correspond  with  the  number  of  azimuthing 
propellers  in  the  ship  file  specified  by  Record  (4). 

Record  (20),  Initial  Azimuthing  Propeller  Deflection  Velocities 

This  record  is  optional. 

“aziPropellerDeflectVelsODeg” ,  aziPropellerDeflectVelsODeg  (1  character  string, 
nAziPropeller  floats) 

“aziPropellerDeflectVelsODeg”  Record  tag. 

aziPropellerDeflectVelsODeg  Initial  azimuthing  propeller  velocities  (deg/s,  + 

counter-clockwise  viewed  from  inside  hull).  If 
this  record  is  not  given,  then  defaults  of  0  deg/s 
are  used.  If  this  record  is  given,  then  the  number 
of  values  should  correspond  with  the  number  of 
azimuthing  propellers  in  the  ship  file  specified  by 
Record  (4). 
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Record  (21),  Initial  Azimuthing  Propeller  RPMs 

This  record  is  optional. 

“aziPropellerRpmsO” ,  aziPropcllerRpmsO  (1  character  string,  nAziPropcllcr 
floats) 

“aziPropellerRpmsO”  Record  tag. 

aziPropcllerRpmsO  Initial  azimuthing  propeller  RPM  values.  If  this  record  is 

not  given,  then  defaults  of  0  RPM  are  used.  If  this  record 
is  given,  then  the  number  of  values  should  correspond 
with  the  number  of  azimuthing  propellers  in  the  ship  file 
specified  by  Record  (4). 

Record  (22),  Initial  U-tube  Tank  Fluid  Displacements 

This  record  is  optional. 

“uTubeTankFluidDispsODeg”,  uTubeTankFluidDispsODeg  (1  character  string, 
nUTubeTank  floats) 

“uTubeTankFluidDispsODeg”  Record  tag. 

uTubeTankFluidDispsODeg  Initial  U-tube  tank  fluid  displacement  angles 

(deg,  +  fluid  higher  on  port  side).  If  this  record  is 
not  given,  then  defaults  of  0°  are  used.  If  this 
record  is  given,  then  the  number  of  values  should 
correspond  with  the  number  of  U-tube  tanks  in 
the  ship  file  specified  by  Record  (4). 

Record  (23),  Initial  U-tube  Tank  Fluid  Velocities 

This  record  is  optional. 

“uTubeTankFluidVelsODeg” ,  uTubeTankFluidVelsODeg  (1  character  string, 
nUTubeTank  floats) 

“uTubeTankFluidVelsODeg”  Record  tag. 

uTubeTankFluidVelsODeg  Initial  fluid  angle  velocities  (deg/s,  +  fluid  moving 

toward  port  side).  If  this  record  is  not  given,  then 
defaults  of  0  deg/s  are  used.  If  this  record  is  given, 
then  the  number  of  values  should  correspond  with 
the  number  of  U-tube  tanks  in  the  ship  file 
specified  by  Record  (4). 
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Record  (24),  Beginning  of  Maneuvers 

This  record  can  be  followed  by  Records  (24a)  to  (24j)  repeated  in  arbitrary  order, 
“begin  maneuvers”  (1  character  string  with  2  words) 

Record  (24a),  Propeller  RPM  Command 

This  record  is  optional. 

“SetRpm”,  keyPropeller,  rpm  Comm  and  (2  character  strings,  1  float) 

“SetRpm”  Record  tag. 

keyPropeller  Key  for  propeller.  A  value  “All”  sets  all  propellers. 
rpmCommand  Command  propeller  RPM  (RPM). 

Record  (24b),  Course  Command  for  Rudder 

This  record  is  optional. 

“SetRudderCourse” ,  keyRudder,  shipHeadingToCommandDeg  (2  character 
strings,  1  float) 

“SetRudderCourse”  Record  tag. 

keyRudder  Key  for  rudder.  A  value  ”A11”  sets  all  rudders. 

shipHeadingToCommandDeg  Ship  heading  x  (deg)  to  which  autopilot  is  set. 

Record  (24c),  Rudder  Deflection  Command 

This  record  is  optional. 

“SetRudderDeflect” ,  keyRudder,  deflect CommandDeg  (2  character  strings,  1 
float) 

“SetRudderDeflect”  Record  tag. 

keyRudder  Key  for  rudder.  A  value  “All”  sets  all  rudders. 

deflectCommandDeg  Command  rudder  deflection  angle  (deg,  + 

counter-clockwise  viewed  from  inside  the  hull).  For  a  ship 
with  a  conventional  rudder  pointing  downward,  a  positive 
rudder  deflection  turns  the  ship  to  starboard. 
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Record  (24d),  Azimuthing  Propeller  RPM  Command 

This  record  is  optional. 

“SetAziPropellcrRpm” ,  keyAziPropcller,  rpmCommand  (2  character  strings,  1 
float) 

“SetAziPropellerRpm”  Record  tag. 

keyAziPropcller  Key  for  azimuthing  propeller.  A  value  “All”  sets  all 

azimuthing  propellers. 

rpmCommand  Command  RPM  for  azimuthing  propeller  (RPM). 

Record  (24e),  Course  Command  for  Azimuthing  Propeller 

This  record  is  optional. 

“SetAziPropellcrCourse” ,  keyAziPropeller,  shipHeadingToCommandDeg  (2 
character  strings,  1  float) 

“SetAziPropellcrCourse”  Record  tag. 

keyAziPropcller  Key  for  azimuthing  propeller.  A  value  “All”  sets 

all  azimuthing  propellers. 

shipHeadingToCommandDeg  Ship  heading  x  (deg)  to  which  azimuthing 

propeller  autopilot  is  set. 

Record  (24f),  Azimuthing  Propeller  Deflection  Command 

This  record  is  optional. 

“SetAziPropllerDeflect” ,  keyAziPropcller,  deflect CommandDeg  (2  character 
strings,  1  float) 

“SetAziPropllerDeflect”  Record  tag. 

keyAziPropcller  Key  for  azimuthing  propeller.  A  value  “All”  sets  all 

azimuthing  propellers. 

deflect  CommandDeg  Command  azimuthing  propeller  deflection  angle  (deg, 

+  counter-clockwise  viewed  from  inside  the  hull).  For  a 
ship  with  a  conventional  azimuthing  propeller  pointing 
downward,  a  positive  azimuthing  propeller  deflection 
turns  the  ship  to  starboard. 
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Record  (24g),  Turn  to  Absolute  Heading  Maneuver  Command 

This  record  is  optional. 

“TurnAbsHeading” ,  finalHeadingDeg,  tElapsedMax  (optional)  (1  character 
string,  1  or  2  floats) 

“TurnAbsHeading”  Record  tag. 


finalHeadingDeg 

Ship  heading  x  (deg,  0  for  north)  at  which  the  program 
considers  the  command  completed.  To  ensure  completion  of 
a  turn,  a  SetRudder  command  should  normally  be  made 
before  a  TurnAbsHeading  command. 

tElapsedMax 

Time  limit  (s)  for  attempting  to  reach  heading 
FinalHeadingDeg.  If  this  input  is  not  included,  then  a 
default  value  of  3600  s  is  used. 

Record  (24h),  Turn  Change  in  Heading  Maneuver  Command 

This  record  is  optional. 

“TurnDeltaHeading” ,  deltaHeadingDeg,  tElapsedMax  (optional)  (1  character 
string,  1  or  2  floats) 

“TurnDeltaHeading”  Record  tag. 


deltaHeadingDeg 

Change  from  initial  heading  at  which  the  program 
considers  the  turn  maneuver  completed.  To  ensure 
completion  of  a  turn,  a  SetRudder  or 

SetAziPropllerDeflect  command  should  normally  be  made 
before  a  TurnDeltaHeading  command. 

tElapsedMax 

Time  limit  (s)  for  attempting  to  reach  change  in  heading 
deltaHeadingDeg.  If  this  input  is  not  included,  then  a 
default  value  of  3600  s  is  used. 
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Record  (24i),  Straight  Distance  Maneuver  Command 

This  record  is  optional. 

“StraightDistance” ,  distance,  tElapsedMax  (optional)  (1  character  string,  1  or  2 
floats) 


“StraightDistance’' 

distance 

tElapsedMax 


Record  tag. 

Straight  line  distance  (nr)  between  start  and  end  points  at 
which  the  program  considers  the  maneuver  completed. 

Time  limit  (s)  for  attempting  to  traverse  distance 
StraightDistance.  If  this  input  is  not  included,  then  a 
default  value  of  3600  s  is  used. 


Record  (24j),  Elapsed  Time  Maneuver  Command 

This  record  is  optional. 

“ElapsedTime”,  tElapsedMax  (1  character  string,  1  float) 
“ElapsedTinre”  Record  tag. 


tElapsedMax 


Elapsed  time  at  which  the  program  considers  the  maneuver 
completed. 


Record  (24k),  End  of  Maneuvers 

This  record  is  required  after  all  maneuvers  described  using  Records  (24a)  to  (24j). 
“end  maneuvers”  (1  character  string  with  2  words) 

Record  (25),  Time  Intervals  for  Output  Time  Series  and  Console 

“outTimelntervals” ,  dtOutTimeSeries,  dtOutConsole  (1  character  string,  1  float) 
“outTimelntervals”  Record  tag. 


dtOutTimeSeries 


dtOutConsole 


Time  interval  for  output  time  series  written  to  file  (s).  If 
this  value  is  set  to  <  dtMax  from  Record  (12),  then  output 
values  will  be  at  an  interval  of  dtMax. 

Time  interval  for  written  simulation  progress  to  console.  If 
this  value  is  set  to  <  dtMax  from  Record  (12),  then  output 
values  will  be  at  an  interval  of  dtMax. 
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Record  (26),  Output  Ship  Motion  Time  Interval  and  Options 

“outTimeSeries” ,  outDispOption,  outVelOption,  outAccOption  (4  character 
strings) 

“outTimeSeries”  Record  tag. 


outDispOption 

Option  for  giving  output  ship  displacements: 

Disp  -  Output  displacements  are  given. 

NoDisp  -  No  output  displacements  are  given. 

outVelOption 

Option  for  giving  output  ship  velocities: 

Vel  -  Output  velocities  are  given. 

NoVel  -  No  output  velocities  are  given. 

outAccOption 

Option  for  giving  output  ship  accelerations: 

Acc  -  Output  accelerations  are  given. 

NoAcc  -  No  output  accelerations  are  given. 
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Record  (27),  Output  Time  Series  Options  for  Rudders,  Propellers,  Az- 
imuthing  Propellers,  and  U-Tube  Tanks 

“outAppendage” ,  outRudderOption,  outPropOption,  outAziPropOption, 
outUTubeTankOption  (5  character  strings) 


“outAppendage’' 

outRudderProp 


outPropOption 


Record  tag. 

Option  for  giving  output  rudder  motions: 

Rudder  -  Output  rudder  times  series  are  given. 

NoRudder  -  No  rudder  time  series  are  given. 

Option  for  giving  output  propeller  RPMs: 

Prop  -  Output  propeller  RPM  times  series  are  given. 

NoProp  -  No  propeller  RPM  time  series  are  given. 

Option  for  giving  output  azimuthing  propeller  deflections 
RPMs: 

AziProp  -  Output  azimuthing  propeller  deflection  and 
RPM  times  series  are  given. 

NoAziProp  -  No  azimuthing  propeller  time  series  are 
given. 

outUTubeTankOption  Option  for  giving  output  U-tube  tank  fluid  motions: 

UTubeTank  -  Output  U-tube  tank  times  series  are  given. 
NoUTubeTank  -  No  U-tube  tank  time  series  are  given. 


outAziPropOption 


Record  (28),  Plot  Option 

“plotOutOption” ,  plotOutOption  (2  character  strings) 

“plotOutOption”  Record  tag. 

plotOutOption  Option  for  making  plots  of  trajectories  and  time  series. 
NoPlots  -  No  plots  are  produced. 

ScreenFile  -  Plots  are  both  plotted  on  the  screen  and  to  a  hie. 
Screen  -  Plots  are  only  plotted  on  the  screen. 

File  -  Plots  are  only  written  to  a  hie. 
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Record  (29),  Beginning  of  Trajectory  Plot  Data 

This  record  is  optional. 

“begin  trajectoryPlot”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  must  be  followed  by  Records  (29a)  to 
(29e)  giving  plot  parameters. 

Record  (29a),  Trajectory  Plot  Image  File  Name 

This  record  is  required  if  a  trajectory  plot  is  being  specified. 

“imageFileName” ,  imageFileName  (2  character  strings) 

“imageFileName”  Record  tag. 
imageFileName  Name  of  output  plot  Hie. 

Record  (29b),  Trajectory  Plot  Image  Format 

This  record  is  optional  if  a  trajectory  plot  is  being  specified. 

“imageFormat” ,  imageFormat  (2  character  strings) 

“imageFormat”  Record  tag. 

imageFormat  Plot  image  format.  Available  formats  are  png  (default)  and  jpg. 

Record  (29c),  Trajectory  Plot  Image  Size 

This  record  is  optional  if  a  trajectory  plot  is  being  specified. 

“imageSize”,  widthmm,  heightmm  (1  character  string,  2  floats) 

“imageSize”  Record  tag. 

widthmm  Plot  width  (mm).  (Default  150  mm) 

heightmm  Plot  height  (mm).  (Default  100  mm) 
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Record  (29d),  Trajectory  Plot  Drawing  of  Ship 

This  record  is  optional  if  a  trajectory  plot  is  being  specified. 

“shipDrawing”,  shipSpacingND,  lengthBeamRatio  (1  character  string,  2  floats) 
“shipDrawing”  Record  tag. 

shipSpacingND  Non-dimensional  spacing  of  drawings  of  ship  on  plot  (default 
5.0). 

lengthBeamRatio  Length  to  beam  ratio  of  drawn  ship  (default  8.0). 


Note: 


If  this  record  is  omitted  for  a  plot,  then  the  default  values  are 
used. 


Record  (29e),  End  of  Trajectory  Plot  Data 

“end  trajectoryPlot”  (1  character  string  with  2  words) 

Record  (30),  Beginning  of  Displacement  Time  Series  Plot  Data 

This  record  is  optional. 

“begin  displacementPlots”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (30a)  to  (30e)  giving  plot  parameters.  Record 
(30f)  must  follow  at  the  end  of  plot  parameter  data. 

Record  (30a),  Displacement  Plot  Image  File  Name 

This  record  is  required  if  a  displacement  plot  is  being  specified. 

“imageFileName” ,  imageFileName  (2  character  strings) 

“imageFileName”  Record  tag. 
imageFileName  Name  of  output  plot  hie. 

Record  (30b),  Displacement  Plot  Image  Format 

This  record  is  optional  if  a  displacement  plot  is  being  specified. 

“imageFormat” ,  imageFormat  (2  character  strings) 

“imageFormat”  Record  tag. 

imageFormat  Plot  image  format.  Available  formats  are  png  (default)  and  jpg. 
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Record  (30c),  Displacement  Plot  Image  Size 

This  record  is  optional  if  a  displacement  plot  is  being  specified. 
“imageSize”,  widthmm,  heightmm  (1  character  string,  2  floats) 
“imageSize”  Record  tag. 

widthmm  Plot  width  (mm).  (Default  150  mm) 
heightmm  Plot  height  (mm).  (Default  100  mm) 

Record  (30d),  Column  Options  for  Motion  Displacements 

This  record  is  optional  if  a  plot  is  being  specified 

“motionColumns” ,  xfColumn,  yfColumn,  heaveColumn,  rollColumn, 
pitchColumn,  headingColumn  (7  character  strings) 


“motionColumns” 

Record  tag. 

Values  for  each  of  the  following  can  be  one 

Left 

Right 

Hide 

xfColumn 

Column  of  Xf  graph  (default  Left). 

yfColumn 

Column  of  y/  graph  (default  Left). 

heaveColumn 

Column  of  heave  graph  (default  Left). 

rollColumn 

Column  of  roll  graph  (default  Left). 

pitchColumn 

Column  of  pitch  graph  (default  Left). 

headingColumn 

Column  of  heading  graph  (default  Left). 
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Record  (30e),  Column  Options  for  Rudder  and  Propeller  Displacements 

This  record  is  optional  if  a  plot  is  being  specified. 

“rudderPropColumns” ,  rudderDeflectColumn,  propellerRpmColumn, 
aziPropcller  Deflect  Column,  aziPropcllerRpmColumn  (5  character  strings) 

“rudderPropColumns”  Record  tag. 

Values  for  each  of  the  following  can  be  one  of: 

Left 


rudderDeflectColumn 
propellerRpmColumn 
aziPropeller  Deflect  Column 

aziPropellerRpmColumn 


Right 

Hide 

Column  of  rudder  deflection  graph  (default  Hide). 

Column  of  propeller  RPM  graph  (default  Hide). 

Column  of  azimuthing  propeller  deflection  graph 
(default  Hide). 

Column  of  azimuthing  propeller  RPM  graph  (default 
Hide). 


Record  (30f),  End  of  Displacement  Time  Series  Plot  Data 

“end  displacementPlots”  (1  character  string  with  2  words) 


Record  (31),  Beginning  of  Velocity  Time  Series  Plot  Data 

This  record  is  optional. 

“begin  velocityPlots”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (31a)  to  (31e)  giving  plot  parameters.  Record 
(31f)  must  follow  at  the  end  of  plot  parameter  data. 


Record  (31a),  Velocity  Plot  Image  File  Name 

This  record  is  required  if  a  velocity  plot  is  being  specified. 
“imageFileName” ,  imageFileName  (2  character  strings) 
“imageFileName”  Record  tag. 
imageFileName  Name  of  output  plot  file. 
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Record  (31b),  Velocity  Plot  Image  Format 

This  record  is  optional  if  a  velocity  plot  is  being  specified. 

“imageFormat” ,  imageFormat  (2  character  strings) 

“imageFormat”  Record  tag. 

imageFormat  Plot  image  format.  Available  formats  are  png  (default)  and  jpg. 

Record  (31c),  Velocity  Plot  Image  Size 

This  record  is  optional  if  a  velocity  plot  is  being  specified. 

“imageSize”,  widthmm,  heightmm  (1  character  string,  2  floats) 

“imageSize”  Record  tag. 

widthmm  Plot  width  (mm).  (Default  150  mm) 

heightmm  Plot  height  (mm).  (Default  100  mm) 
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Record  (31d),  Column  Options  for  Motion  Velocities 

This  record  is  optional  if  a  velocity  plot  is  being  specified. 

“motionColumns” ,  speedColumn,  latVelColumn,  xfColumn,  yfColumn, 
heaveColumn,  rollColumn,  pitchColumn,  headingColumn  (9  character  strings) 

“motionColumns”  Record  tag. 

Values  for  each  of  the  following  can  be  one  of: 

Left 


Right 

Hide 

speedColumn 

Column  of 

latVelColumn 

Column  of 

xfColumn 

Column  of 

yfColumn 

Column  of 

heaveColumn 

Column  of 

rollColumn 

Column  of 

pitchColumn 

Column  of 

headingColumn 

Column  of 

speed  graph  (default  Left), 
lateral  velocity  graph  (default  Left). 
Xf  velocity  graph  (default  Hide). 

Uf  velocity  graph  (default  Hide), 
heave  velocity  graph  (default  Left), 
roll  velocity  graph  (default  Left), 
pitch  velocity  graph  (default  Left), 
heading  velocity  graph  (default  Left). 
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Record  (31e),  Column  Options  for  Rudder  and  Propeller  Velocities 

This  record  is  optional  if  a  plot  is  being  specified. 


“rudderPropColumns” ,  rudderDeflectColumn,  propellerRpmColumn, 
aziPropcller  Deflect  Column,  aziPropcllerRpmColumn  (5  character  strings) 


“rudderPropColumns”  Record  tag. 

Values  for  each  of  the  following  can  be  one  of: 
Left 


Right 

Hide 


rudderDeflectColumn  Column  of  rudder  deflection  velocity  graph  (default 

Hide). 

propellerRpmColumn  Column  of  propeller  RPM  rate  of  change  graph 

(default  Hide). 


aziPropellerDeflectColumn  Column  of  azimuthing  propeller  deflection  velocity 

graph  (default  Hide). 


aziPropcllerRpmColumn  Column  of  azimuthing  propeller  RPM  rate  of  change 

graph  (default  Hide). 


Record  (31f),  End  of  Velocity  Time  Series  Plot  Data 

“end  velocityPlots”  (1  character  string  with  2  words) 


Record  (32),  Beginning  of  Acceleration  Time  Series  Plot  Data 

This  record  is  optional. 

“begin  accelerationPlots”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (32a)  to  (32e)  giving  plot  parameters.  Record 
(32f)  must  follow  at  the  end  of  plot  parameter  data. 
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Record  (32a),  Acceleration  Plot  Image  File  Name 

This  record  is  required  if  an  acceleration  plot  is  being  specified. 

“imageFileName” ,  imageFileName  (2  character  strings) 

“imageFileName”  Record  tag. 
imageFileName  Name  of  output  plot  file. 

Record  (32b),  Acceleration  Plot  Image  Format 

This  record  is  optional  if  an  acceleration  plot  is  being  specified. 

“imageFormat” ,  imageFormat  (2  character  strings) 

“imageFormat”  Record  tag. 

imageFormat  Plot  image  format.  Available  formats  are  png  (default)  and  jpg. 

Record  (32c),  Acceleration  Plot  Image  Size 

This  record  is  optional  if  an  acceleration  plot  is  being  specified. 

“imageSize”,  widthmm,  heightmm  (1  character  string,  2  floats) 

“imageSize”  Record  tag. 

widthmm  Plot  width  (mm).  (Default  150  mm) 

heightmm  Plot  height  (mm).  (Default  100  mm) 
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Record  (32d),  Column  Options  for  Motion  Accelerations 

This  record  is  optional  if  an  acceleration  plot  is  being  specified 

“motionColumns” ,  longAccColumn,  latAccColumn,  xfColnmn,  yfColumn, 
heaveColumn,  rollColumn,  pitchColumn,  headingColumn  (9  character  strings) 

“motionColumns”  Record  tag. 

Values  for  each  of  the  following  can  be  one  of: 

Left 


Right 

Hide 


longAccColumn 

Column  of 

latAccColumn 

Column  of 

xfColumn 

Column  of 

yfColumn 

Column  of 

heaveColumn 

Column  of 

rollColumn 

Column  of 

pitchColumn 

Column  of 

headingColumn 

Column  of 

longitudinal  acceleration  graph  (default  Left), 
lateral  acceleration  graph  (default  Left). 

Xf  acceleration  graph  (default  Hide). 

Uf  acceleration  graph  (default  Hide), 
heave  acceleration  graph  (default  Left), 
roll  acceleration  graph  (default  Left), 
pitch  acceleration  graph  (default  Left), 
heading  acceleration  graph  (default  Left). 
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Record  (32e),  Column  Options  for  Rudder  and  Propeller  Accelerations 

This  record  is  optional  if  an  acceleration  plot  is  being  specified. 

“rudderPropColumns” ,  rudderDeflectColumn,  propellerRpmColumn, 
aziPropcller  Deflect  Column,  aziPropcllerRpmColumn  (5  character  strings) 

“rudderPropColumns”  Record  tag. 


rudderDeflectColumn 

Values  for  each  of  the  following  can  be  one  of: 

Left 

Right 

Hide 

Column  of  rudder  deflection  acceleration  graph 
(default  Hide). 

propellerRpmColumn 

Column  of  propeller  RPM  acceleration  graph 
(default  Hide). 

aziPropellerDeflectColumn 

Column  of  azimuthing  propeller  deflection 
acceleration  graph  (default  Hide). 

aziPropellerRpmColumn 

Column  of  azimuthing  propeller  RPM  acceleration 
graph  (default  Hide). 

Record  (32f),  End  of  Acceleration  Time  Series  Plot  Data 

“end  accelerationPlots”  (1  character  string  with  2  words) 

Record  (33),  Beginning  of  Appendage  Time  Series  Plot  Data 

This  record  is  optional. 

“begin  appendagePlots”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (33a)  to  (33f)  giving  plot  parameters.  Record 
(33i)  must  follow  at  the  end  of  plot  parameter  data. 
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Record  (33a),  Appendage  Plot  Image  File  Name 

This  record  is  required  if  a  plot  is  being  specified. 

“imageFileName” ,  imageFileName  (2  character  strings) 

“imageFileName”  Record  tag. 
imageFileName  Name  of  output  plot  file. 

Record  (33b),  Appendage  Plot  Image  Format 

This  record  is  optional  if  a  plot  is  being  specified. 

“imageFormat” ,  imageFormat  (2  character  strings) 

“imageFormat”  Record  tag. 

imageFormat  Plot  image  format.  Available  formats  are  png  (default)  and  jpg. 

Record  (33c),  Appendage  Plot  Image  Size 

This  record  is  optional  if  a  plot  is  being  specified. 

“imageSize”,  widthmm,  heightmm  (1  character  string,  2  floats) 

“imageSize”  Record  tag. 

widthmm  Plot  width  (mm).  (Default  150  mm) 

heightmm  Plot  height  (mm).  (Default  100  mm) 
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Record  (33d),  Column  Options  for  Rudder  Deflections 

This  record  is  optional  if  a  plot  is  being  specified. 

“rudder  Deflect  Columns” ,  rudderDeflectColumn,  rudderDeflectVelColumn, 
rudderDeflectAccColumn  (4  character  strings) 

“rudderColumns”  Record  tag. 

Values  for  each  of  the  following  can  be  one  of: 

Left 


rudderDeflectColumn 

rudderDeflectVelColumn 

rudderDeflectAccColumn 


Right 

Hide 

Column  of  rudder  deflection  graph  (default  Left). 

Column  of  rudder  deflection  velocity  graph  (default 
Left). 

Column  of  rudder  deflection  velocity  graph  (default 
Hide). 


Record  (33e),  Column  Options  for  Propeller  RPMs 

This  record  is  optional  if  a  plot  is  being  specified. 

“propcllerRpmColunms” ,  propellcrRpmColumn,  propellerRpmVelColumn, 
propellerRpmAccColumn  (4  character  strings) 

“propcllerRpmColunms”  Record  tag. 

Values  for  each  of  the  following  can  be  one  of: 

Left 


Right 

Hide 

propeller RpmColumn  Column  of  propeller  RPM  graph  (default  Left). 

propellerRpmVelColumn  Column  of  propeller  RPM  rate  of  change  graph 

(default  Hide). 

propellerRpmAccColumn  Column  of  propeller  RPM  acceleration  graph  (default 

Hide). 
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Record  (33f),  Column  Options  for  Azimuthing  Propeller  Deflections 

This  record  is  optional  if  a  plot  is  being  specified. 


“aziPropellerDeflect Columns” ,  aziPropellerDeflectColumn, 
aziPropellerDeflectVelColumn,  aziPropcllerDeflectAccColumn  (4  character 
strings) 

“aziPropellerDeflectColumns”  Record  tag. 

Values  for  each  of  the  following  can  be  one  of: 
Left 


Right 

Hide 

aziPropellerDeflectColumn  Column  of  rudder  deflection  graph  (default  Left). 

aziProp cller Deflect VelColumn  Column  of  rudder  deflection  velocity  graph 

(default  Left). 

aziPropellerDeflectAccColumn  Column  of  rudder  deflection  velocity  graph 

(default  Hide). 


Record  (33g),  Column  Options  for  Azimuthing  Propeller  RPMs 

This  record  is  optional  if  a  plot  is  being  specified. 

“aziPropellerRpmColumns” ,  aziPropellerRpmColumn, 

aziPropcllerRpmVelColunm,  aziPropellerRpmAccColunm  (4  character  strings) 
“aziPropellerRpmColumns”  Record  tag. 

Values  for  each  of  the  following  can  be  one  of: 
Left 


Right 

Hide 

aziPropellerRpmColumn  Column  of  azimuthing  propeller  RPM  graph 

(default  Left). 

aziPropcllerRpmVelColumn  Column  of  azimuthing  propeller  RPM  rate  of 

change  graph  (default  Hide). 

aziPropellerRpmAccColunm  Column  of  azimuthing  propeller  RPM  acceleration 

graph  (default  Hide). 
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Record  (33h),  Column  Options  for  U-tube  Tank  Displacements 

This  record  is  optional  if  a  plot  is  being  specified. 

“uTubeTankColumns” ,  uTubeTankDispColumn,  uTubeTankVelColumn, 
uTubeTankAccColumn  (4  character  strings) 

“uTubeTankColumns”  Record  tag. 


uTubeTankDispColumn 

Values  for  each  of  the  following  can  be  one  of: 

Left 

Right 

Hide 

Column  of  U-tube  tank  fluid  displacement  graph 
(default  Left). 

uTubeTankVelColumn 

Column  of  U-tube  tank  fluid  velocity  graph  (default 
Left). 

uTubeTankAccColumn 

Column  of  U-tube  tank  acceleration  velocity  graph 
(default  Hide). 

Record  (33i),  End  of  Appendage  Time  Series  Plot  Data 

“end  appendagePlots”  (1  character  string  with  2  words) 

Record  (34),  End  of  Ship  Motion  Simulation  Ship  Data 

“end  SM3DFreeMo3”  (1  character  string  with  2  words) 
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B.2  Sample  Input  File  for  SM3DFreeMo3 

begin  SM3DFreeMo3 
label  Generic  frigate 

shipDBFileName  genFrigShipForMotionDB.bin 
lengthData  120.000  20.000 

loadCondition  1025.000  4.200  0.000  6.000  0.0000 

timeSeriesFileName  genFrigTimeSeries.bin 
seawayCalraOption  Seaway 
seawayFileName  bretSeaState5Seaway . xml 
timeParameters  0.2  0  20  20 
hullForceNonLinearOption  Linear 
dispsFixedOMDeg  000000 
speedOKnots  20 
rpmsPropellersO  166.5  166.5 
begin  maneuvers 

SetRpm  All  166.5 
SetRudderCourse  All  0 
ElapsedTime  100 
end  maneuvers 
outTimelntervals  0.4  10 
outTimeSeries  Disp  ¥el  Acc 

outAppendage  Rudder  Prop  NoAziProp  NoUTubeTank 
plotOutOption  noPlots 
end  SM3DFreeMo3 
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B.3  Sample  Output  File  for  SM3DFreeMo3  (Time 
Series  Data  Removed) 

Program  SM3DFreeMo3 

ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Time  :  November-09-11  8:21:25  AM 
Run  label: 

Generic  frigate 


****  ECHO  OF  USER  INPUT  **** 


Input  ship  database  file  name: 
genFrigShipForMotionDB.bin 
Label  :  Generic  frigate 
Created  :  November-09-11  8:19:55  AM 

Version  :  ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Class  :  ShipMo3D . ShipForMotionDB 

Ship  Length  Data 

Length  between  perpendiculars  :  120.000  m 

Station  of  aft  perpendicular  :  20.000 

Ship  Loading  Condition 
Water  density  :  1025.000  kg/m3 
Draft  of  baseline  at  midships 
Trim  of  baseline  by  stern 
Height  of  CG  above  baseline,  KG 
Correction  to  metacentric  height  GM 

Output  motion  time  series  file  name: 
genFrigTimeSeries .bin 
Seaway  calm  option  :  Seaway 

Seaway  file  name: 
bretSeaState5Seaway . xml 

Label  :  Hs  =  3.25  m,  Tp  =  9.7  s,  Bretschneider  spectrum 
Created  :  November-09-11  8:21:26  AM 

Version  :  ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Class  :  ShipMo3D. DeepSeaway. FixedMultiSeaway 


4.200  m 
0.000  m 
6.000  m 
0.000  m 


Time  parameters 
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Time  step 
Initial  time 

End  of  wave  ramp  function 
Beginning  of  statistics  sampling 


0.200  s 
0.000  s 
20.000  s 
20.000  s 


Option  for  nonlinear  buoyancy  and  incident  wave  forces  :  Linear 


Initial 

xf 

yf 

Heave 

Roll 

Pitch 

Heading 


ship  position 
:  0.000  m  (+  north) 

:  0.000  m  (+  west) 

:  0.000  m  (+  up,  relative  to  calm  water  position) 

:  0.000  deg  (+  port  up) 

:  0.000  deg  (+  bow  down) 

:  0.000  deg  (0  north,  90  east) 


Initial  ship  speed  : 


20.000  knots 


Initial  ship  velocity  components 


xf  velocity 
yf  velocity 
Heave  velocity 
Roll  velocity 
Pitch  velocity 
Heading  velocity 
Initial  rudder  deflections  (deg)  (default) 
0.000 

Initial  rudder  velocities  (deg/s)  (default) 
0.000 


10.300  m/s 
0.000  m/s 
0.000  m/s 
0.000  deg/s 
0.000  deg/s 
0.000  deg/s 


(+  north) 

(+  west) 

(+  up,  relative  to  calm  water  position) 
(+  port  up) 

(+  bow  down) 

(0  north,  90  east) 


Initial  propeller  RPMs  (input) 
166.500  166.500 


Beginning  of  maneuvering  commands 
SetRpm  All  166.5 
SetRudderCourse  All  0 
ElapsedTime  100 
End  of  maneuvering  commands 


**  Output  options  for  time  series 

Output  file  time  interval  :  0.400  s 

Time  interval  for  console  message  :  10.000  s 
Options  for  writing  time  series  to  files 
Displacements  :  Disp 

Velocities  :  Vel 
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Accelerations  :  Acc 

Rudder  deflections  :  Rudder 

Propeller  RPM  :  Prop 

Azimuth  propeller  deflections  &&  RPM  :  NoAziProp 

**  Output  plot  options 

Plot  output  option  :  NoPlots 

****  SHIP  LOADING  CONDITION  **** 

Load  Condition  Properties  for  Trimmed  Ship 

Summary  of  hydrostatic  properties 
Number  of  panels  on  port  side 
Total  number  of  panels 
Length  between  perpendiculars 
Draft  of  baseline  at  midships 
Trim  of  baseline  by  stern 
Beam  based  on  maximum  y  value 
Volume 

Water  density 
Mass 

Distance  from  FP  to  X  origin  (m) 

(Origin  located  at  LCG) 

Station  of  X  origin 
Center  of  buoyancy  wrt  waterline 
Wetted  surface  area 
Waterplane  area 

X  value  of  center  of  floatation 
Integral  of  waterplane  area*X**2 
Integral  of  waterplane  area*Y**2 
KG,  height  of  CG  above  baseline 
Height  of  CG  above  waterline 
Metacentric  height  from  hydrostatics 

Inertial  Properties 


Inertia  matrix. 

units  of 

kg,  kg*m,  and  kg*m2 

3712917 

0 

0 

0 

0 

0 

0 

3712917 

0 

0 

0 

0 

0 

0 

3712917 

0 

0 

0 

0 

0 

0  85545601 

0 

0 

0 

0 

0 

0 

3341625051 

0 

0 

0 

0 

0 

0 

3341625051 
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-1.614  m 
1753.438  m2 
1344.310  m2 
-5.022  m 
1234204.219  m4 
17543.814  m4 
6.000  m 
1.800  m 
1.430  m 


1226 

120.000  m 
4.200  m 
0.000  m 
14.111  m 
3622.358  m3 
1025.000  kg/m3 
3712916.723463  kg 
61.750  m 


Roll  radius  of  gyration  :  4.800  m 

Pitch  radius  of  gyration  :  30.000  m 

Yaw  radius  of  gyration  :  30.000  m 

Roll  Metacentric  Height  Properities 

Roll  metacentric  height  from  hull  hydrostatics 
Correction  due  to  sloshing  tanks 
Input  correction  to  roll  metacentric  height 
Corrected  metacentric  height 


1.430  m 
0.000  m 
0.000  m 
1.430  m 


Roll  Properties  at  Zero  Forward  Speed 


Roll  added  mass 

Nondimensional  roll  added  mass  A44/I44 
Natural  roll  frequency 
Natural  roll  period 


19662081.124976  kg*m**2 
0.230 

0.703  rad/s 
8.933  s 


****  SHIP  AUTOPILOT  SETTINGS  **** 


Rudder  autopilots  for  ShipAutopilot  for  freely  maneuvering  ship 


Key  :  Rudder 
Label  :  Rudder 


Maximum  deflection 
Maximum  velocity 
Maximum  acceleration 
Response  frequency 
Response  damping 
Maximum  time  step 
Acceleration  attentuation 


35.000  deg 
3.000  deg/s 
Not  set  deg/s2 
3.000  rad/s 

0.850  rad/s  (fraction  of  critical) 

0.100  s 

0.010 


(applied  when  displacement  or  velocity  limits  exceeded) 

Autopilot  gains 

Displacement  gains  have  units  of  deg/m  and  deg/deg 
Velocity  gains  have  units  of  deg/ (m/s)  and  deg/ (deg/s) 

Yaw  gains  given  relative  to  earth-fixed  axes  (+yaw  is  clockwise) 


Displacement  gains  : 
Velocity  gains  : 

Integration  gains  : 
Integration  time  :  0. 


xf 

yf 

Heave 

0.000 

0.000 

0.000 

0.000 

0.000 

0.000 

0.000 

0.000 

0.000 

s 


Roll 

Pitch 

Yaw 

0.000 

0.000 

-4.000 

0.000 

0.000 

-8.000 

0.000 

0.000 

0.000 
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****  INITIALIZING  FreeShipInSeaway TD  OBJECT  **** 


CPU  time  for  initialization  of  FreeShipInSeaway TD  :  6.158  s 

****  SIMULATING  SHIP  MOTIONS  **** 


Executing  command  at  time  0.000 
SetRpm  All  166.5 
Executing  command  at  time  0.000 
SetRudderCourse  All  0 
Executing  command  at  time  0.000 
Simulated  time  : 

CPU  time  : 

Ratio  CPU/simulated  time  : 


100.000 

0.318 

0.003 


s 

s 


****  COMPUTED  SHIP  MOTIONS  **** 


Time  series  summary 


Beginning  and  end  times  for  statistics (s) 

20.200 

100. 

.000 

Displacements,  xf  and  yf 

in  earth- 

-fixed  axes 

Mode 

Mean 

Dev 

Max 

Min 

tz  (s) 

xf  (m) 

611.201 

233 . 547 

1015.486 

206.201 

0.000 

yf  (m) 

0.000 

0.000 

0.000 

0.000 

6.164 

heave  (m) 

0.002 

0.581 

1.511 

-1.626 

6.050 

roll  (deg) 

0.000 

0.000 

0.000 

0.000 

7.280 

pitch  (deg) 

0.023 

1.174 

3.274 

-3.254 

5.240 

heading  (to)  (deg) 

Rudder  deflections  (deg) 

0.000 

0.000 

0.000 

0.000 

5.569 

Rudder 

0.000 

0.000 

0.000 

0.000 

5.554 

Propeller  RPM 
PortPropeller 

166.500 

0.000 

166.500 

166.500 

0.000 

StarboardPropeller 

166.500 

0.000 

166.500 

166.500 

0.000 

Velocities,  uf  and  vf  in 

earth-fixed  axes 

Mode 

Mean 

Dev 

Max 

Min 

tz  (s) 

uf  (m/s2) 

10.141 

0.106 

10.445 

9.880 

7.040 

vf  (m/s2) 

0.000 

0.000 

0.000 

0.000 

5.569 

heave  (m/s2) 

-0.015 

0.615 

1.766 

-1.557 

5.200 

roll  (deg/s) 

0.000 

0.000 

0.000 

0.000 

7.018 

pitch  (deg/s) 

0.026 

1.292 

3.146 

-3.720 

5.214 

heading  (to)  (deg/s) 
Rudder  velocities  (deg/s) 

0.000 

0.000 

0.000 

0.000 

5.569 

Rudder 

0.000 

0.000 

0.000 

0.000 

5.554 
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10.445 


Ship  speed  along  instantaneous  heading 
Speed  (m/s)  10.141  0.106 


9.880  7.040 


Accelerations,  xf  and  yf  acceleration  m  earth-fixed  axes 


Mode 

Mean 

acc-xf  (deg/s2) 

0.002 

acc-yf  (deg/s2) 

0.000 

heave  (deg/s2) 

-0.005 

roll  (deg/s2) 

0.000 

pitch  (deg/s2) 

-0.018 

heading  (to)  (deg/s2) 

0.000 

Dev 

Max 

Min 

tz 

(s) 

0. 

.100 

0. 

.245 

-0. 

.251 

5. 

.569 

0. 

.000 

0. 

.000 

0, 

.000 

4. 

.494 

0. 

.684 

1. 

.898 

-1. 

.841 

5. 

.229 

0. 

.000 

0. 

.000 

0, 

.000 

6. 

.050 

1, 

.480 

4. 

.037 

-4, 

.  131 

4. 

.840 

0. 

.000 

0. 

.000 

0, 

.000 

5. 

.093 
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Annex  C:  Files  for  Motions  in  a  Regular 

Seaway  with  SM3DSeakeepRegular3 

C.1  Format  of  Input  File  for  SM3DSeakeepRegular3 

Record  (1),  Beginning  Record 

“begin  SM3DSeakeepRegular3”  (1  character  string  with  2  words) 

Record  (2),  Run  Label 

“label” ,  label  (2  character  strings) 

“label”  Record  tag. 

label  Label  for  run.  This  can  include  spaces. 

Record  (3),  Beginning  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

“begin  note”  (1  character  string  with  2  words) 

Record  (3a),  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

noteText  (character  string) 

noteText  Text  of  note.  Multiple  lines  can  be  entered. 

Record  (3b),  End  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

“end  note”  (1  character  string  with  2  words) 
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Record  (4),  Input  Ship  Database  File  Name 

“shipDBFileName” ,  shipDBFileName  (2  character  strings) 

“shipDBFileName”  Record  tag. 

shipDBFileName  Name  of  input  ship  database  hie  in  .NET  binary 

serialization  format.  This  hie  must  have  been  created  using 
program  SM3DBuildShip3. 


Record  (5),  Length  Data 

“lengthData” ,  lpp,  stationAP  (1  character  string,  2  boats) 

“lengthData”  Record  tag. 

lpp  Ship  length  between  perpendiculars  (m) 

stationAP  Station  number  of  the  aft  perpendicular.  This  value  is  typically 


20.0 


Note:  The  values  in  this  record  must  agree  with  the  values  used  for  the 

ship  database  hie  specihed  in  Record  (4).  Values  are  considered 
to  be  in  agreement  when  they  are  within  a  tolerance  of  0.001  m 
for  length,  and  0.001  for  the  station  of  the  aft  perpendicular.  The 
output  hie  from  SM3DBuildShip3  gives  the  values  of  the  above 
parameters. 
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Record  (6),  Ship  Loading  Condition 

“loadCondition” ,  waterDensity,  draftBIMid,  trimBIStern,  shipKG,  correctionGM 
(1  character  string,  5  floats) 


“loadCondition” 

waterDensity 

draftBIMid 

trimBIStern 

shipKG 

correctionGM 


Record  tag. 

Water  density  p  (kg/m3). 

Draft  of  baseline  at  midships  (m). 

Trim  of  baseline  by  stern  (m). 

Height  of  centre  of  gravity  above  baseline  (m). 
Correction  to  metacentric  height  (m). 


Note:  The  values  in  this  record  must  agree  with  the  values  used  for 

the  ship  database  file  specified  in  Record  (4).  Values  are 
considered  to  be  in  agreement  when  they  are  within  a  tolerance 
of  0.001  kg/m3  for  density,  and  0.001  m  for  draft,  trim,  height 
of  CG,  and  metacentric  height.  The  output  file  from 
SM3DBuildShip3  gives  the  values  of  the  above  parameters. 


Record  (7),  Beginning  of  Rudder  Autopilot  Settings 

Records  (7)  to  (7e)  are  optional. 

“begin  rudderAutopilotSettings”  (2  character  strings) 

Note:  Records  (7)  to  (7e)  are  optional  and  can  be  used  to  supersede  autopilot 
settings  for  a  ship  defined  by  SM3DBuildShip3  given  in  the  file  of  Record 
(4).  Within  Records  (7)  to  (7e),  Records  (7a)  to  (7d)  can  be  repeated  an 
arbitrary  number  of  times  to  set  rudder  autopilot  parameters  as  required. 


Record  (7a),  Rudder  Key  for  Autopilot  Settings 

“key Rudder”  keyRudder  (2  character  strings) 

This  Record  must  follow  Record  (7)  if  autopilot  settings  are  being  given  as  input. 
“keyRudder”  Record  tag. 

keyRudder  Key  of  rudder  for  which  autopilot  settings  are  being  specified.  If 
the  rudder  key  is  set  to  ”  All” ,  then  the  input  autopilot  settings 
are  applied  to  all  rudders. 
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Record  (7b),  Rudder  Autopilot  Control  Parameters 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a). 

“controlParam” ,  deflectMaxDeg,  velMaxDeg,  accMaxDeg,  freqResponse, 
dampResponse,  dtMax  (1  character  string,  6  floats) 

“controlParam”  Record  tag. 


deflectMaxDeg 

Maximum  rudder  deflection  angle  (deg).  This  value  is  typically 
set  to  35°. 

velMaxDeg 

Maximum  rudder  deflection  velocity  (deg/s).  If  this  value  is  set 
to  0.0,  then  the  maximum  velocity  is  unlimited. 

accMaxDeg 

Maximum  rudder  acceleration  (deg/s2).  If  this  value  is  set  to 
0.0,  then  the  maximum  acceleration  is  unlimited. 

freqResponse 

Undamped  response  frequency  of  rudder  autopilot. 

dampResponse 

Damping  of  rudder  autopilot  as  a  fraction  of  critical  damping. 
This  value  is  typically  between  0.5  and  1.0. 

dtMax 

Maximum  time  increment  for  time  stepping  of  rudder  motions. 
This  parameter  doesn’t  affect  frequency  domain  computations 
with  SM3DSeakeepRegular. 

Note: 

If  this  record  is  not  included  after  Record  (7a),  then  the 
original  values  for  the  given  ship  rudder  autopilot  are  used. 
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Record  (Tc),  Rudder  Autopilot  Displacement  Gains 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a). 

“dispGains”,  surgeGain,  swayGain,  heaveGain,  rollGain,  pitchGain,  yawGain  (1 
character  string,  6  floats) 


“dispGains” 

surgeGain 

swayGain 

heaveGain 

rollGain 


Record  tag. 

Surge  gain  (deg/m).  This  value  should  be  0.0. 

Sway  gain  (deg/m).  This  value  should  be  0.0. 

Heave  gain  (deg/m).  This  value  is  typically  0.0. 

Roll  gain  (deg/deg).  This  value  is  typically  0.0  unless  rudder  roll 
stabilization  is  desired. 


pitchGain 

yawGain 


Note: 


Pitch  gain  (deg/deg).  This  value  is  typically  0.0. 

Yaw  gain  (deg/deg).  Note  that  the  input  yaw  gain  is  defined 
according  to  ship  motions  in  earth-fixed  axes,  for  which  positive 
yaw  motion  is  clockwise.  For  a  typical  ship  with  a  downward 
oriented  rudder,  this  value  is  typically  <  0.0. 

If  this  record  is  not  included  after  Record  (7a),  then  the  original 
values  for  the  given  ship  rudder  autopilot  are  used. 
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Record  (7d),  Rudder  Velocity  Gains 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a). 

“velGains”,  surge VelGain,  swayVelGain,  heave VelGain,  rollVelGain, 
pitchVelGain,  yaw  VelGain  (1  character  string,  6  floats) 


“velGains” 
surge  VelGain 
swayVelGain 
heave  VelGain 
rollVelGain 


Record  tag. 

Surge  velocity  gain  (deg/ (m/s)).  This  should  be  typically  0.0. 

Sway  velocity  gain  (deg/ (m/s)).  This  should  be  typically  0.0. 

Heave  velocity  gain  (deg/ (m/s)).  This  value  is  typically  0.0. 

Roll  velocity  gain  (deg/ (deg/s)).  This  value  is  typically  0.0  unless 
rudder  stabilization  is  desired. 


pitchVelGain  Pitch  velocity  gain  (deg/ (deg/s)).  This  value  is  typically  0.0. 

yaw  VelGain  Yaw  velocity  gain  (deg/(deg/s)).  Note  that  the  input  yaw  gain  is 

defined  according  to  ship  motions  in  earth-fixed  axes,  for  which 
positive  yaw  motion  is  clockwise.  For  a  typical  ship  with  a 
downward  oriented  rudder,  this  value  is  typically  <  0.0. 


Note:  If  this  record  is  not  included  after  Record  (7a),  then  the  original 

values  for  the  given  ship  rudder  autopilot  are  used. 


Record  (7e),  End  of  Rudder  Autopilot  Settings 

“end  rudderAutopilotSettings”  (2  character  strings) 


Record  (8),  Beginning  of  Azimuthing  Propeller  Force  Slopes 

Records  (8)  to  (8c)  are  required  if  the  ship  has  azimuthing  propellers, 
“begin  aziPropellerForceSlopes”  (2  character  strings) 


Record  (8a),  Key  of  Azimuthing  Propeller  for  Force  Slopes 

Records  (8a)  to  (8b)  are  required  for  each  azimuthing  propeller. 
“keyAziPropellcr”  keyAziPropellcr  (2  character  strings) 
“keyAziPropellcr”  Record  tag. 
keyAziPropellcr  Key  of  azimuthing  propeller. 
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Record  (8b),  Ship  Speed  and  Azimuthing  Propeller  Force  Slopes 

This  record  can  be  repeated  an  arbitrary  number  of  times  after  Record  (8a). 
Note  that  ship  speeds  must  be  in  ascending  order. 


“aziPropcllerForceSlopes” ,  speedAziPropellcr,  deflectForceSlopeDeg, 
normalForceSlopeDeg  (1  character  string,  3  floats) 


“aziPropellerForceSlopes”  Record  tag. 


speedAziPropeller 


Ship  speed  (m/s)  corresponding  to  force  slopes. 


deflectForceSlopeDeg  Deflection  force  slope  dF/d8  (N/deg)  for  azimuthing 

propeller,  where  F  is  the  force  perpendicular  to  the 
longitudinal  axis  of  the  ship  and  6  is  the  deflection 
angle  of  the  propeller.  This  term  is  typically  greater 
than  zero,  and  includes  contributions  from  both  the 
propeller  thrust  and  the  force  normal  to  the  propeller 
axis  when  the  propeller  has  a  deflection  angle. 

normalForceSlopeDeg  Normal  force  slope  dFN /da  (N/deg)  for  azimuthing 

propeller,  where  FN  is  the  force  normal  to  the 
propeller  and  a  is  the  flow  angle  of  attack.  This  term 
is  typically  greater  than  zero  and  somewhat  less  than 
the  previous  term  deflectForceSlopeDeg  ( dF/d5 ). 


Note: 


The  above  required  input  terms  are  given  in  the 
output  from  SM3DBuildShip3. 


Record  (8c),  End  of  Azimuthing  Propeller  Force  Slopes 

This  record  is  required  if  the  ship  has  azimuthing  propellers. 

“end  aziPropcllerForceSlopes”  (2  character  strings) 

Record  (9),  Beginning  of  Azimuthing  Propeller  Deflection  Controller 

Settings 

Records  (9)  to  (9e)  are  optional. 

“begin  aziPropcllerDeflectControllcrSettings”  (2  character  strings) 

Note:  Records  (9)  to  (9e)  are  optional  and  can  be  used  to  supersede  autopilot 
settings  for  a  ship  defined  by  SM3DBuildShip3  given  in  the  file  of  Record 
(4).  Within  Records  (9)  to  (9e),  Records  (9a)  to  (9d)  can  be  repeated  an 
arbitrary  number  of  times  to  set  azimuthing  propeller  controller 
parameters  as  required. 
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Record  (9a),  Azimuthing  Propeller  Key  for  Controller  Settings 

This  record  must  follow  Record  (9)  if  controller  settings  are  being  given  as  input. 
“keyAziPropellcr”  keyAziPropellcr  (1  character  string,  1  integer) 
“keyAziPropeller”  Record  tag. 

keyAziPropellcr  Key  of  azimuthing  propeller  for  which  controller  settings  are 
being  specified.  If  this  key  to  set  to  “All” ,  then  the  input 
controller  settings  are  applied  to  all  azimuthing  propellers. 


Record  (9b),  Azimuthing  Propeller  Deflection  Controller  Parameters 

This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (9a). 

“deflect ControlParam” ,  deflectMaxDeg,  deflect  VelMaxDeg,  deflectAccMaxDeg, 
deflectFreqResponse,  deflectDampResponse,  deflectDtMax  (1  character  string,  6 
floats) 


“deflect ControlParam”  Record  tag. 

deflectMaxDeg  Maximum  deflection  angle  (deg).  This  value  is  typically 

set  to  35°. 


deflect  VelMaxDeg  Maximum  deflection  velocity  (deg/s).  If  this  value  is  set 

to  0.0,  then  the  maximum  velocity  is  unlimited. 

deflectAccMaxDeg  Maximum  deflection  acceleration  (deg/s2).  If  this  value 

is  set  to  0.0,  then  the  maximum  acceleration  is 
unlimited. 


deflectFreqResponse  Undamped  response  frequency  of  deflection  controller. 

deflectDampResponse  Damping  of  deflection  controller  as  a  fraction  of  critical 

damping.  This  value  is  typically  between  0.5  and  1.0. 


deflectDtMax  Maximum  time  increment  for  time  stepping  of 

azimuthing  propeller  deflections.  This  parameter  doesn’t 
affect  frequency  domain  computations  with 
SM3DSeakeepRegular. 

Note:  If  this  record  is  not  included  after  Record  (9a),  then  the 

original  values  for  the  given  azimuthing  propeller 
controller  are  used. 
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Record  (9c),  Azimuthing  Propeller  Deflection  Controller  Displacement 
Gains 


This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (9a) 

“deflectDispGains” ,  surgeGain,  swayGain,  heaveGain,  rollGain,  pitchGain, 
yawGain  (1  character  string,  6  floats) 

“deflectDispGains”  Record  tag. 


surgeGain 

Surge  gain  (deg/m).  This  value  should  be  0.0. 

swayGain 

Sway  gain  (deg/m).  This  value  should  be  0.0. 

heaveGain 

Heave  gain  (deg/m).  This  value  is  typically  0.0. 

rollGain 

Roll  gain  (deg/deg).  This  value  is  typically  0.0  unless  roll 
stabilization  is  desired. 

pitchGain 

Pitch  gain  (deg/deg).  This  value  is  typically  0.0. 

yawGain 

Yaw  gain  (deg/deg).  Note  that  the  input  yaw  gain  is  defined 
according  to  ship  motions  in  earth-fixed  axes,  for  which 
positive  yaw  motion  is  clockwise.  For  a  ship  using  a 
downward  oriented  azimuthing  propeller  for  course  keeping, 
this  value  is  typically  <  0.0. 

Note: 

If  this  record  is  not  included  after  Record  (9a),  then  the 
original  values  for  the  given  azimuthing  propeller  controller 
are  used. 
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Record  (9d),  Azimuthing  Propeller  Deflection  Controller  Velocity  Gains 

This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (9a). 

“deflect  VelGains” ,  surge  VelGain,  swayVelGain,  heave VelGain,  rollVelGain, 
pitchVelGain,  yaw  VelGain  (1  character  string,  6  floats) 


“deflect  VelGains” 
surge  VelGain 
swayVelGain 
heave  VelGain 
rollVelGain 


Record  tag. 

Surge  velocity  gain  (deg/ (m/s)).  This  value  should  be  0.0. 

Sway  velocity  gain  (deg/ (m/s)).  This  value  should  be  0.0. 

Heave  velocity  gain  (deg/ (m/s)).  This  value  is  typically  0.0 

Roll  velocity  gain  (deg/(deg/s)).  This  value  is  typically  0.0 
unless  stabilization  is  desired. 


pitchVelGain 

yawVelGain 


Note: 


Pitch  velocity  gain  (deg/ (deg/s)).  This  value  is  typically  0.0. 

Yaw  velocity  gain  (deg/ (deg/s)).  Note  that  the  input  yaw 
gain  is  defined  according  to  ship  motions  in  earth-fixed  axes, 
for  which  positive  yaw  motion  is  clockwise.  For  a  ship  using  a 
downward  oriented  azimuthing  propeller  for  course  keeping, 
this  value  is  typically  <  0.0. 

If  this  record  is  not  included  after  Record  (9a),  then  the 
original  values  for  the  given  azimuthing  propeller  controller 
are  used. 


Record  (9e),  End  of  Azimuthing  Propeller  Controller  Settings 

“end  aziPropellcrDeflectControllerSettings”  (2  character  strings) 
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Record  (10),  Output  Options 

“outOptions” ,  outRudderRaoOption,  outAziPropRaoOption, 
outUTubeTankRaoOption,  outRollDampOption  (5  character  strings) 


“outOptions” 

Record  tag. 

outRudderRaoOption 

Option  for  writing  rudder  motions  values: 

Rudder Rao  -  Rudder  motions  are  written  to  output. 

NoRudderRao  -  Rudder  motions  are  not  written  to 
output. 

outAziPropRaoOption 

Option  for  writing  azimuthing  propeller  deflections: 

AziPropRao  -  Azimuthing  propeller  deflections  are 
written  to  output. 

NoAziPropRao  -  Azimuthing  propeller  deflections  are 
not  written  to  output. 

outUTubeTankRaoOption 

Option  for  writing  U-tube  tank  fluid  displacements: 

UTubeTankRao  -  U-tube  tank  fluid  displacements 
are  written  to  output. 

NoUTubeTankRao  -  U-tube  tank  fluid  displacements 
are  not  written  to  output. 

outRollDampOption 

Option  for  writing  roll  damping  values: 

RollDamp  -  Roll  damping  coefficients  are  written  to 
output. 

NoRollDamp  -  Roll  damping  coefficients  are  not 
written  to  output. 
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Record  (11),  Output  Response  Amplitude  Operator  File  Name  for  Post- 
Processing 

“outMoDefRaoPprOption” ,  outMoDefRaoPprOption  (2  character  strings) 
“outMoDefRaoPprOption”  Record  tag. 

outMoDefRaoPprOption  Option  for  output  of  data  file  with  motion  and 

appendage  deflections  response  amplitude  operators 
for  post-processing. 

MotDefRaoPpr  -  Motion  and  appendage  deflection 
RAOs  are  written  to  a  hie  in  .NET  binary  format. 

NoMoDefRaoPpr  -  Motion  and  appendage  deflection 
RAOs  are  not  written  to  a  hie  in  .NET  binary 
format. 

Record  (12),  Output  Response  Amplitude  Operator  File  Name 

This  record  should  only  be  given  if  outMoDefRaoPprOption  in  Record  (11)  is  set 
to  MoDefRaoPpr. 

“moDefRaoPprFileName”,  moDefRaoPprFileName  (2  character  strings) 
“moDefRaoPprFileName”  Record  tag. 

moDefRaoPprFileName  Name  of  output  hie  for  response  amplitude  operators 

in  .NET  binary  format. 

Record  (13),  Minimum  Wave  Encounter  Frequency 

“enFreqMinMotion” ,  enFreqMinMotion  (1  character  string,  1  hoat) 
“enFreqMinMotion”  Record  tag. 

enFreqMinMotion  Minimum  wave  encounter  frequency  for  ship  motion 

predictions.  If  the  combination  of  ship  speed,  heading,  and 
wave  frequency  gives  an  encounter  frequency  less  than  this 
value,  then  the  wave  frequency  is  shifted.  This  variable  is 
used  to  avoid  large  amplitude  motions  at  very  low 
encounter  frequencies.  A  value  of  approximately  0.3 \J gfL 
is  recommended. 
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Record  (14a),  Ship  Speed  Range  in  m/s 

One  of  Records  (14a)  to  (14f)  must  be  given. 

“speedRange” ,  speedMin,  speedMax,  speedlnc  (1  character  string,  3  floats) 

“speedRange”  Record  tag. 

speedMin  Minimum  ship  speed  (m/s). 

speedMax  Maximum  ship  speed  (m/s). 

speedlnc  Increment  for  ship  speed  (m/s). 

Record  (14b),  Ship  Speeds  in  m/s 

One  of  Records  (14a)  to  (14f)  must  be  given. 

“speeds”,  speeds  (1  character  string,  array  of  floats) 

“speeds”  Record  tag. 

speeds  Array  of  ship  speeds  (m/s). 

Record  (14c),  Ship  Speed  Range  in  Knots 

One  of  Records  (14a)  to  (14f)  must  be  given. 

“speedKnotsRange” ,  speedKnotsMin,  speedKnotsMax,  speedKnotsInc  (1 
character  string,  3  floats) 

“speedKnotsRange”  Record  tag. 

speedKnotsMin  Minimum  ship  speed  (knots). 

speedKnotsMax  Maximum  ship  speed  (knots). 

speedKnotsInc  Increment  for  ship  speed  (knots). 

Record  (14d),  Ship  Speeds  in  Knots 

One  of  Records  (14a)  to  (14f)  must  be  given. 

“speedsKnots” ,  speedsKnots  (1  character  string,  array  of  floats) 

“speedsKnots”  Record  tag. 

speedsKnots  Array  of  ship  speeds  (knots). 
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Record  (14e),  Froude  Number  Range 

One  of  Records  (14a)  to  (14f)  must  be  given. 

“FroudeRange” ,  froudeMin,  froudeMax,  froudelnc  (1  character  string,  3  floats) 

“FroudeRange”  Record  tag. 

froudeMin  Minimum  Froude  number. 

froudeMax  Maximum  Froude  number. 

froudelnc  Froude  number  increment. 

Record  (14f),  Ship  Froude  Numbers 

One  of  Records  (14a)  to  (14f)  must  be  given. 

“Froudes”,  froudes  (1  character  string,  array  of  floats) 

“Froudes”  Record  tag. 

froudes  Array  of  ship  Froude  numbers. 

Record  (15a),  Range  of  Sea  Directions  Relative  to  the  Ship 

One  of  Records  (15a)  or  (15b)  must  be  given. 

“seaDirDegRange”,  seaDirDegMin,  seaDirDegMax,  seaDirDeglnc  (1  character 
string,  3  floats) 

“seaDirDegRange”  Record  tag. 

seaDirDegMin  Minimum  sea  direction  relative  to  ship  (deg). 

seaDirDegMax  Maximum  sea  direction  relative  to  ship  (deg). 

seaDirDeglnc  Increment  sea  direction  relative  to  ship  (deg). 

Record  (15b),  Sea  Directions  Relative  to  the  Ship 

One  of  Records  (15a)  or  (15b)  must  be  given. 

“seaDirsDeg” ,  seaDirsDeg  (1  character  string,  array  of  floats) 

“seaDirsDeg”  Record  tag. 

seaDirsDeg  Array  of  sea  directions  relative  to  the  ship  (deg)  . 
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Record  (16a),  Range  of  Incident  Wave  Frequencies 

One  of  Records  (16a)  or  (16b)  must  be  given. 

“waveFreqRange” ,  waveFreqMin,  waveFreqMax,  waveFreqlnc  (1  character  string, 
3  floats) 

“waveFreqRange”  Record  tag. 

waveFreqMin  Minimum  incident  wave  frequency  (rad/s). 

waveFreqMax  Maximum  incident  wave  frequency  (rad/s). 

waveFreqlnc  Increment  for  incident  wave  frequency  (rad/s). 

Record  (16b),  Incident  Wave  Frequencies 

One  of  Records  (16a)  or  (16b)  must  be  given. 

“waveFreqs”,  waveFreqs  (1  character  string,  array  of  floats) 

“waveFreqs”  Record  tag. 

waveFreqs  Array  of  increasing  incident  wave  frequencies  (rad/s). 

Record  (IT),  Input  Wave  Amplitude  Option 

“waveAmpOption” ,  waveAmpOption  (2  character  strings) 

“waveAmpOption”  Record  tag. 

waveAmpOption  Option  for  input  wave  amplitudes  as  a  function  of  wave 

frequency: 

ConstantAmplitude  -  All  waves  have  the  same  amplitude  a. 

ConstantSteepness  -  All  waves  have  the  same  steepness  H/X. 

Variable  Amplitude  -  Wave  amplitude  a  varies  with 
frequency. 

Record  (17a),  Wave  Amplitude 

This  Record  must  be  given  if  waveAmpOption  is  set  to  ConstantAmplitude  in 
Record  (17). 

“waveAmp”,  waveAmp  (1  character  string,  1  float) 

“waveAmp”  Record  tag. 

waveAmp  Wave  amplitude  at  all  wave  frequencies  (m). 
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Record  (17b),  Wave  Steepness 

This  Record  must  be  given  if  waveAmpOption  is  set  to  ConstantSteepness  in 
Record  (17). 

“waveSteepness” ,  waveSteepness  (1  character  string,  1  float) 

“waveSteepness”  Record  tag. 

waveSteepness  Wave  steepness  H/X  at  all  wave  frequencies.  The  wave  slope 
ka  is  related  to  the  wave  steepness  as  follows: 

k  a  =  7r  H/ X  (C.l) 


Record  (17c),  Wave  Amplitudes 

This  record  must  be  given  if  waveAmpOption  is  set  to  VariableAmplitude  in 
Record  (17). 

“waveAmps”,  waveAmps  (1  character  string,  array  of  floats) 

“waveAmps”  Record  tag. 

waveAmps  Wave  amplitudes  for  wave  frequencies.  The  number  of  wave 

amplitudes  must  correspond  to  the  number  of  wave  frequencies 
given  by  Record  (16a)  or  Record  (16b). 

Record  (18),  Beginning  of  Seakeeping  Position  Data 

This  record  is  optional. 

“begin  seakeepPositions”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (18a)  to  (18c)  giving  seakeeping  position 
parameters.  Record  (18d)  must  follow  at  the  end  of  seakeeping  position 
data. 

Record  (18a),  Seakeeping  Position  Label 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 

“labelPos”,  labelPos  (2  character  strings) 

“labelPos”  Record  tag. 

labelPos  Label  for  seakeeping  position.  This  can  include  spaces. 
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Record  (18b),  Seakeeping  Position  Location 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 
“locationPos”,  stationPos,  yPos,  zBIPos  (1  character  string,  3  floats) 
“locationPos”  Record  tag. 

stationPos  Station  for  seakeeping  position.  Station  0  is  at  the  fore 
perpendicular. 

yPos  Lateral  coordinate  (+  port)  relative  to  ship  centreline  (m). 

zBIPos  Vertical  coordinate  (+  up)  relative  to  ship  baseline  (m). 


Record  (18c),  Option  for  Including  Radiation  and  Diffraction  in  Relative 
Vertical  Motion 

This  record  is  optional  if  a  seakeeping  position  is  being  specified. 
“relMoRadDifOption”,  relMoRadDifOption  (2  character  strings) 
“relMoRadDifOption”  Record  tag. 

relMoRadDifOption  Option  for  including  radiation  and  diffraction  in  relative 

vertical  motion: 

NoRadDif  -  Wave  radiation  and  diffraction  are  not 
considered  when  evaluating  relative  wave  motion 
(default). 


Record  (18d),  End  of  Seakeeping  Position  Data 

This  record  is  required  if  Record  (18)  is  present. 

“end  seakeepPositions”  (1  character  string  with  2  words) 


Record  (19),  Beginning  of  Wave  Kinematics  Position  Data 

This  record  is  optional. 

“begin  waveKinPositions”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (19a)  to  (19c)  giving  wave  kinematics  position 
parameters.  Record  (19d)  must  follow  at  the  end  of  wave  kinematics 
position  data. 
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Record  (19a),  Wave  Kinematics  Position  Label 

This  record  is  required  if  a  wave  kinematic  position  is  being  specified. 
“labelWaveKin”,  labelWaveKin  (2  character  strings) 

“labelWaveKin”  Record  tag. 

labelWaveKin  Label  for  wave  kinematic  position.  This  can  include  spaces. 


Record  (19bl),  Wave  Kinematics  Position  Station  and  Elevation  Rela¬ 
tive  to  Baseline 


One  of  Record  (19bl),  (19b2),  or  (19b3)  is  required  if  a  wave  kinematics  position 
is  being  specified. 

“stationYZBIWaveKin”,  stationWaveKin,  yWaveKin,  zBIWaveKin  (1  character 
string,  3  floats) 

“stationYZBIWaveKin”  Record  tag. 


stationWaveKin 


yWaveKin 


zBIWaveKin 


Station  for  wave  kinematic  position.  Station  0  is  at  the 
fore  perpendicular. 

Lateral  coordinate  (+  port)  relative  to  ship  centreline 

(m). 

Vertical  coordinate  (+  up)  relative  to  ship  baseline  (m). 
If  this  position  is  above  the  calm  waterline  for  the 
trimmed  ship,  then  it  is  moved  to  the  calm  waterline. 
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Record  (19b2),  Wave  Kinematics  Position  Station  and  Elevation  Rela¬ 
tive  to  Calm  Waterline 


One  of  Record  (19bl),  (19b2),  or  (19b3)  is  required  if  a  wave  kinematics  position 
is  being  specified. 


“stationYZWIWaveKin” ,  stationWaveKin,  yWaveKin,  zWIWaveKin  (1  character 
string,  3  floats) 


“stationYZWIWaveKin” 

stationWaveKin 

yWaveKin 

zWIWaveKin 


Record  tag. 

Station  for  wave  kinematic  position.  Station  0  is  at  the 
fore  perpendicular. 

Lateral  coordinate  (+  port)  relative  to  ship  centreline 
(m). 

Vertical  coordinate  (+  up)  relative  to  the  calm 
waterline  (m). 


Record  (19b3),  Wave  Kinematics  Position  X  Coordinate  and  Elevation 
Relative  to  Calm  Waterline 


One  of  Record  (19bl),  (19b2),  or  (19b3)  is  required  if  a  wave  kinematics  position 
is  being  specified. 

“xYZWIWaveKin” ,  xWaveKin,  yWaveKin,  zWIWaveKin  (1  character  string,  3 
floats) 

“xYZWIWaveKin”  Record  tag. 


xWaveKin 


yWaveKin 


x  coordinate  (+  forward,  relative  to  ship  CG)  for  wave 
kinematic  position  (m). 

Lateral  coordinate  (+  port)  relative  to  ship  centreline  (m). 


zWIWaveKin 


Vertical  coordinate  (+  up)  relative  to  the  calm  waterline 
(m). 
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Record  (19c),  Option  for  Including  Radiation  and  Diffraction  in  Wave 
Kinematics 

This  record  is  optional  if  a  wave  kinematics  position  is  being  specified. 
“waveKinRadDifOption” ,  waveKinRadDifOption  (2  character  strings) 
“waveKinRadDifOption”  Record  tag. 

waveKinRadDifOption  Option  for  including  radiation  and  diffraction  in  wave 

kinematics: 

NoRadDif  -  Wave  radiation  and  diffraction  are  not 
considered  when  evaluating  wave  kinematics  (default). 

Record  (19d),  End  of  Wave  Kinematics  Position  Data 

This  record  is  required  if  Record  (19)  is  present. 

“end  waveKinPositions”  (1  character  string  with  2  words) 

Record  (20),  Plot  Output  Option 

“plotOutOption” ,  plotOutOption  (2  character  strings) 

“plotOutOption”  Record  tag. 

plotOutOption  Option  for  making  plots  of  motion  response  amplitude 
operators: 

NoPlots  -  No  plots  are  produced. 

ScreenFile  -  Plots  are  both  plotted  on  the  screen  and  to  a  file. 
Screen  -  Plots  are  only  plotted  on  the  screen. 

File  -  Plots  are  only  written  to  a  file. 

Record  (21),  Beginning  of  Ship  Motion  RAO  Plot  Data 

This  record  is  optional. 

“begin  motionRaoPlots”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (21a)  to  (21h)  giving  plot  parameters.  Record 
(21i)  must  follow  at  the  end  of  plot  parameter  data. 
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Record  (21a),  Motion  RAO  Plot  Image  File  Name 

This  record  is  required  if  a  plot  is  being  specified. 

“imageFileName” ,  imageFileName  (2  character  strings) 

“imageFileName”  Record  tag. 
imageFileName  Name  of  output  plot  file. 

Record  (21b),  Motion  RAO  Plot  Image  Format 

This  record  is  optional  if  a  plot  is  being  specified. 

“imageFormat” ,  imageFormat  (2  character  strings) 

“imageFormat”  Record  tag. 

imageFormat  Plot  image  format.  Available  formats  are  png  (default)  and  jpg. 

Record  (21c),  Motion  RAO  Plot  Image  Size 

This  record  is  optional  if  a  plot  is  being  specified. 

“imageSize”,  widthmm,  heightmm  (1  character  string,  2  floats) 

“imageSize”  Record  tag. 

widthmm  Plot  width  (mm).  (Default  150  mm) 

heightmm  Plot  height  (mm).  (Default  200  mm) 

Record  (21dl),  Motion  RAO  Plot  Speed  in  m/s 

One  of  Records  (21dl),  (21d2),  or  (21d3)  is  required  for  each  plot  being  specified, 
“speed”,  speed  (1  character  string,  1  float) 

“speed”  Record  tag. 

speed  Ship  speed  (m/s)  for  plotted  RAOs.  This  speed  should  correspond  to  a 
speed  specified  for  computations  in  one  of  Records  (14a)  to  (14f). 
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Record  (21d2),  Motion  RAO  Plot  Speed  in  Knots 

One  of  Records  (21dl),  (21d2),  or  (21d3)  is  required  for  each  plot  being  specified. 
“speedKnots” ,  speedKnots  (1  character  string,  1  float) 

“speedKnots”  Record  tag. 

speedKnots  Ship  speed  (knots)  for  plotted  RAOs.  This  speed  must 

correspond  to  a  speed  specified  for  computations  in  one  of 
Records  (14a)  to  (14f). 

Record  (21d3),  Motion  RAO  Plot  Froude  Number 

One  of  Records  (21dl),  (21d2),  or  (21d3)  is  required  for  each  plot  being  specified. 
“Froude”,  Froude  (1  character  string,  1  float) 

“Froude”  Record  tag. 

Froude  Ship  forward  speed  Froude  number  for  plotted  RAOs.  This  speed 
should  correspond  to  a  speed  specified  for  computations  in  one  of 
Records  (14a)  to  (14f) . 

Record  (21e),  Motion  RAO  Plot  Sea  Direction 

This  record  is  required  for  each  plot  being  specified. 

“seaDirDeg”,  seaDirDeg  (1  character  string,  1  float) 

“seaDirDeg”  Record  tag. 

seaDirDeg  Sea  direction  (deg)  relative  to  ship  for  plotted  RAOs.  This  sea 
direction  must  correspond  to  a  sea  direction  specified  for 
computations  in  Record  (15a)  or  (15b). 
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Record  (21f),  Option  for  Longitudinal  and/or  Lateral  Modes 

This  record  is  optional  if  a  plot  is  being  specified. 

“longLatOption”,  longLatOption  (2  character  strings) 
“longLatOption”  Record  tag. 


longLatOption 

Option  for  plotting  modes. 

LongLat  -  Longitudinal  and  lateral  and  inodes  will  be  shown 
with  longitudinal  inodes  in  the  left  column  and  lateral  modes 
in  the  right  column  (default). 

Long  -  Longitudinal  modes  will  be  shown  in  a  single  column. 

Lat  -  Lateral  modes  will  be  shown  in  a  single  column. 

Record  (21g),  Column  Options  for  Longitudinal  Modes 

This  record  is  optional  if  a  plot  is  being  specified 

“longColumns” ,  surgeColnmn,  heaveColumn,  pitchColnmn  (3  character  strings) 
“longColumns”  Record  tag. 


surgeColnmn 

Values  for  each  of  the  following  can  be  one  of: 

Left 

Right 

Hide 

Column  of  surge  graph. 

heaveColumn 

Column  of  heave  graph. 

pitchColnmn 

Column  of  pitch  graph. 

Note: 

The  values  in  this  record  will  override  values  set  based  on 
longLatOption  in  Record  (21f). 
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Record  (21h),  Column  Options  for  Lateral  Modes 

This  record  is  optional  if  a  plot  is  being  specified. 

“latColumns”,  swayColnmn,  rollColumn,  yawColnmn,  deflectColumn  (5 
character  strings) 

“latColumns”  Record  tag. 


swayColnmn 

Values  for  each  of  the  following  can  be  one  of: 

Left 

Right 

Hide 

Column  of  sway  graph. 

rollColumn 

Column  of  roll  graph. 

yawColnmn 

Column  of  yaw  graph. 

deflectColumn 

Column  of  graph  with  rudder  and/or  azimuthing  propeller 
deflection  angle  RAOs. 

Note: 

The  values  in  this  record  will  override  values  set  based  on 
longLatOption  in  Record  (21f). 

Record  (21i),  End  of  Ship  Motion  RAO  Plot  Data 

“end  motionRaoPlots”  (1  character  string  with  2  words) 

Record  (22),  End  Record 

“end  SM3DSeakeepRegular3”  (1  character  string  with  2  words) 
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C.2  Sample  Input  File  for  SM3DSeakeepRegular3 

begin  SM3DSeakeepRegular3 
label  Generic  frigate 

shipDBFileName  genFrigShipForMotionDB.bin 
lengthData  120.000  20.000 

loadCondition  1025.000  4.200  0.000  6.000  0.0000 
outOptions  RudderRao  NoAziPropRao  NoUTubeTankRao  RollDarap 
outMoDefRaoPprOption  MoDefRaoPpr 

raoDef RaoPprFileName  genFrigSeakeepRegularMoDef RaoDB . bin 
enFreqMinMotion  0.1 
speedKnotsRange  0  30  10 
seaDirDegRange  0  180  15 
waveFreqRange  0.2  2  0.05 
waveAmpOption  ConstantSteepness 
waveSteepness  0.02 
begin  seakeepPositions 
labelPos  Seakeeping  position 
locationPos  3  2  12 
relMoRadDif Option  NoRadDif 
end  seakeepPositions 
plotOutOption  NoPlots 
end  SM3DSeakeepRegular3 
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C.3  Sample  Output  File  for  SM3DSeakeepRegular3 
(Motions  Given  for  Only  One  Speed  and  Heading 
Combination) 

Program  SM3DSeakeepRegular3 

ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Time  :  November-10-11  9:07:15  AM 
Run  label : 

Generic  frigate 

****  ECHO  OF  USER  INPUT  **** 

Input  ship  for  motion  database  file  name: 

genFrigShipForMotionDB . bin 

Label  :  Generic  frigate 

Created  :  November-09- 11  8:19:55  AM 

Version  :  ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Class  :  ShipMo3D . ShipForMotionDB 

Ship  Length  Data 

Length  between  perpendiculars  :  120.000  m 

Station  of  aft  perpendicular  :  20.000 

Ship  Loading  Condition 
Water  density  :  1025.000  kg/m3 
Draft  of  baseline  at  midships 
Trim  of  baseline  by  stern 
Height  of  CG  above  baseline,  KG 
Correction  to  metacentric  height  GM 

Output  rudder  motion  option  :  RudderRao 

Output  azimuthing  propeller  deflection  option  :  NoAziPropRao 
Output  U-tube  tank  fluid  displacement  option  :  NoUTubeTankRao 
Output  roll  damping  option  :  RollDamp 

Output  motion  and  deflection  RAO  post-processing  file  option  :  MoDefRaoPpr 
File  name  with  RAOs  for  post-processing  : 
genFrigSeakeepRegularMoDef RaoDB . bin 

Minimum  wave  encounter  frequency  for  predicting  ship  motions  :  0.100  rad/s 
Speed  range 

Minimum  :  0.000  knots 

Maximum  :  30.000  knots 

Increment  :  10.000  knots 

Sea  direction  range 
Minimum  :  0.000  deg 

Maximum  :  180.000  deg 


4.200  m 
0.000  m 
6.000  m 
0.000  m 
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Increment  :  15.000  deg 


Incident  wave  frequency  range 


Minimum 

Maximum 

Increment 


0.200  rad/s 
2.000  rad/s 
0.050  rad/s 


Input  wave  amplitude  option  :  ConstantSteepness 
Wave  steepness  for  all  frequencies  :  0.020 

Incident  wave  conditions 


Frequency 

(rad/s) 

0.200 

0.250 

0.300 

0.350 

0.400 

0.450 

0.500 

0.550 

0.600 

0.650 

0.700 

0.750 

0.800 

0.850 

0.900 

0.950 

1.000 

1.050 

1.100 

1.150 

1.200 

1.250 

1.300 

1.350 

1.400 

1.450 

1.500 

1.550 

1.600 

1.650 

1.700 

1.750 

1.800 

1.850 

1.900 

1.950 

2.000 


Amplitude 

(m) 

15.403 

9.858 

6.846 

5.030 

3.851 

3.043 

2.465 

2.037 

1.711 

1.458 

1.257 

1.095 

0.963 

0.853 

0.761 

0.683 

0.616 

0.559 

0.509 

0.466 

0.428 

0.394 

0.365 

0.338 

0.314 

0.293 

0.274 

0.256 

0.241 

0.226 

0.213 

0.201 

0.190 

0.180 

0.171 

0.162 

0.154 


Steepness 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 

0.020000 


Slope 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 

0.062832 
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Seakeeping  Positions 


Label  :  Seakeeping  position 

Station  :  3.000 

Lateral  offset  y  :  2.000  m  (+  port) 

Vertical  offset  zBl  :  12.000  m  (+  up,  relative  to  baseline) 

Option  for  including  radiation  and  diffraction  for  relative  motion  :  NoRadDif 

(input) 


Plot  output  option  :  NoPlots 
****  SHIP  LOADING  CONDITION  **** 


Load  Condition  Properties  for  Trimmed  Ship 


Summary  of  hydrostatic  properties 
Number  of  panels  on  port  side 
Total  number  of  panels 
Length  between  perpendiculars 
Draft  of  baseline  at  midships 
Trim  of  baseline  by  stern 
Beam  based  on  maximum  y  value 
Volume 

Water  density 
Mass 

Distance  from  FP  to  X  origin  (m) 
(Origin  located  at  LCG) 

Station  of  X  origin 
Center  of  buoyancy  wrt  waterline 
Wetted  surface  area 
Waterplane  area 

X  value  of  center  of  floatation 
Integral  of  waterplane  area*X**2 
Integral  of  waterplane  area*Y**2 
KG,  height  of  CG  above  baseline 
Height  of  CG  above  waterline 
Metacentric  height  from  hydrostatics 


613 

1226 

120.000  m 
4.200  m 
0.000  m 
14.111  m 
3622.358  m3 
1025.000  kg/m3 
3712916.723463  kg 


61. 

.750 

m 

10, 

,292 

-1. 

,614 

m 

1753. 

,438 

m2 

1344. 

.310 

m2 

-5. 

,022 

m 

1234204. 

,219 

m4 

17543. 

,814 

m4 

6. 

,000 

m 

1. 

,800 

m 

1. 

,430 

m 

Inertial  Properties 


irtia  matrix, 

3712916.7 

units  of  kg, 
0.0 

kg*m ,  and  kg*m2 
0.0 

0.0 

0.0 

0.0 

0.0 

3712916.7 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

3712916.7 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

85545601.3 

0.0 

0.0 

0.0 

0.0 

0.0 

O 

o 

3341625051.1 

0.0 

0.0 

0.0 

0.0 

0.0 

O 

o 

3341625051.1 

Roll  radius  of  gyration 
Pitch  radius  of  gyration 
Yaw  radius  of  gyration 


4.800  m 
30.000  m 
30.000  m 
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Roll  Metacentric  Height  Properities 


)Roll  metacentric  height  from  hull  hydrostatics  : 
Correction  due  to  sloshing  tanks  : 

Input  correction  to  roll  metacentric  height  : 
Corrected  metacentric  height  : 


1.430  m 
0.000  m 
0.000  m 
1.430  m 


Roll  Properties  at  Zero  Forward  Speed 


Roll  added  mass 

Nondimensional  roll  added  mass  A44/I44 
Natural  roll  frequency 
Natural  roll  period 


19548240.530169  kg*m**2 
0.229 

0.704  rad/s 
8.928  s 


****  SHIP  AUTOPILOT  SETTINGS  **** 


Rudder  Autopilots  for  Ship 


Autopilot  for  ship  with  nominally  steady  speed  and  heading 
Key  :  Rudder 
Label  :  Rudder 
Maximum  deflection 
Maximum  velocity 
Maximum  acceleration 
Response  frequency 
Response  damping 
Maximum  time  step 
Autopilot  gains 

Displacement  gains  have  units  of  deg/m  and  deg/deg 
Velocity  gains  have  units  of  deg/ (m/s)  and  deg/ (deg/s) 

Yaw  gains  given  relative  to  earth-fixed  axes  (+yaw  is  clockwise) 


35.000  deg 
3.000  deg/s 
Not  set  deg/s2 
3.000  rad/s 

0.850  rad/s  (fraction  of  critical) 
0.100  s 


Displacement  gains 
Velocity  gains 


Surge 

0.000 

0.000 


Sway 

0.000 

0.000 


Heave 

0.000 

0.000 


Roll 

0.000 

0.000 


Pitch 

0.000 

0.000 


****  SEAKEEPING  POSITION  TRIM  CONDITIONS  **** 


Label 
Station 
x  wrt  ship  CG 

y 

z  wrt  baseline 
z  wrt  ship  CG 
z  wrt  waterline 


Seakeeping  position 
3.000 
43.750  m 
2.000  m 
12.000  m 
6.000  m 
7.800  m 


Yaw 

-4.000 

-8.000 
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Motions  in  Regular  Waves 
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500  3.547  0.003  308  0.003  213  0.003  62  0.004  147  0.001  135  0.001  325 
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Sea  direction  :  150.000  deg  (from,  180  deg  head  seas,  90  deg  waves  from  port) 

Roll  damping  non-dimensionalized  by  critical  roll  damping  at  forward  speed 
Critical  roll  damping  :  147962152.002  Nm/ (rad/s) 
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Annex  D:  Files  for  Motions  in  a  Random 
Seaway  with 
SM3DSeakeepRandom3 

D.1  Format  of  Input  File  for  SM3DSeakeepRandom3 

Record  (1),  Beginning  Record 

“begin  SM3DSeakeepRandom3”  (1  character  string  with  2  words) 

Record  (2),  Run  Label 

“label” ,  label  (2  character  strings) 

“label”  Record  tag. 

label  Label  for  run.  This  can  include  spaces. 

Record  (3),  Beginning  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

“begin  note”  (1  character  string  with  2  words) 

Record  (3a),  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

noteText  (character  string) 

noteText  Text  of  note.  Multiple  lines  can  be  entered. 

Record  (3b),  End  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input,  “end  note”  (1  character  string  with  2  words) 
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Record  (4),  Input  Ship  Database  File  Name 

“shipDBFileName” ,  shipDBFileName  (2  character  strings) 

“shipDBFileName”  Record  tag. 

shipDBFileName  Name  of  input  ship  database  hie  in  .NET  binary 

serialization  format.  This  hie  must  have  been  created  using 
program  SM3DBuildShip3. 


Record  (5),  Length  Data 

“lengthData” ,  lpp,  stationAP  (1  character  string,  2  boats) 

“lengthData”  Record  tag. 

lpp  Ship  length  between  perpendiculars  (m) 

stationAP  Station  number  of  the  aft  perpendicular.  This  value  is  typically 


20.0 


Note:  The  values  in  this  record  must  agree  with  the  values  used  for  the 

ship  database  hie  specihed  in  Record  (4).  Values  are  considered 
to  be  in  agreement  when  they  are  within  a  tolerance  of  0.001  m 
for  length,  and  0.001  for  the  station  of  the  aft  perpendicular.  The 
output  hie  from  SM3DBuildShip3  gives  the  values  of  the  above 
parameters. 
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Record  (6),  Ship  Loading  Condition 

“loadCondition” ,  waterDensity,  draftBIMid,  trimBIStern,  shipKG,  correctionGM 
(1  character  string,  5  floats) 


“loadCondition” 

waterDensity 

draftBIMid 

trimBIStern 

shipKG 

correctionGM 


Record  tag. 

Water  density  (kg/m3). 

Draft  of  baseline  at  midships  (m). 

Trim  of  baseline  by  stern  (m). 

Height  of  centre  of  gravity  above  baseline  (m). 
Correction  to  metacentric  height  (m). 


Note:  The  values  in  this  record  must  agree  with  the  values  used  for 

the  ship  database  file  specified  in  Record  (4).  Values  are 
considered  to  be  in  agreement  when  they  are  within  a  tolerance 
of  0.001  kg/m3  for  density,  and  0.001  m  for  draft,  trim,  height 
of  CG,  and  metacentric  height.  The  output  file  from 
SM3DBuildShip3  gives  the  values  of  the  above  parameters. 


Record  (7),  Beginning  of  Rudder  Autopilot  Settings 

Records  (7)  to  (7e)  are  optional. 

“begin  rudderAutopilotSettings”  (2  character  strings) 

Note:  Records  (7)  to  (7e)  are  optional  and  can  be  used  to  supersede  autopilot 
settings  for  a  ship  defined  by  SM3DBuildShip3  given  in  the  file  of  Record 
(4).  Within  Records  (7)  to  (7e),  Records  (7a)  to  (7d)  can  be  repeated  an 
arbitrary  number  of  times  to  set  rudder  autopilot  parameters  as  required. 


Record  (7a),  Rudder  Key  for  Autopilot  Settings 

This  Record  must  follow  Record  (7)  if  autopilot  settings  are  being  given  as  input. 
“keyRudder”  keyRudder  (2  character  strings) 

“keyRudder”  Record  tag. 

keyRudder  Key  of  rudder  for  which  autopilot  settings  are  being  specified.  If 
the  rudder  key  is  set  to  “All” ,  then  the  input  autopilot  settings 
are  applied  to  all  rudders. 
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Record  (7b),  Rudder  Autopilot  Control  Parameters 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a). 

“controlParam” ,  deflectMaxDeg,  velMaxDeg,  accMaxDeg,  freqResponse, 
dampResponse,  dtMax  (1  character  string,  6  floats) 

“controlParam”  Record  tag. 


deflectMaxDeg 

Maximum  rudder  deflection  angle  (deg).  This  value  is  typically 
set  to  35° 

velMaxDeg 

Maximum  rudder  deflection  velocity  (deg/s).  If  this  value  is  set 
to  0.0,  then  the  maximum  velocity  is  unlimited. 

accMaxDeg 

Maximum  rudder  acceleration  (deg/s2).  If  this  value  is  set  to 
0.0,  then  the  maximum  acceleration  is  unlimited. 

freqResponse 

Undamped  response  frequency  of  rudder  autopilot. 

dampResponse 

Damping  of  rudder  autopilot  as  a  fraction  of  critical  damping. 
This  value  is  typically  between  0.5  and  1.0 

dtMax 

Maximum  time  increment  for  time  stepping  of  rudder  motions. 
This  parameter  doesn’t  affect  frequency  domain  computations 
with  SM3DSeakeepRandom3. 

Note: 

If  this  record  is  not  included  after  Record  (7a),  then  the 
original  values  for  the  given  ship  rudder  autopilot  are  used. 
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Record  (Tc),  Rudder  Autopilot  Displacement  Gains 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a). 

“dispGains”,  surgeGain,  swayGain,  heaveGain,  rollGain,  pitchGain,  yawGain  (1 
character  string,  6  floats) 


“dispGains” 

surgeGain 

swayGain 

heaveGain 

rollGain 


Record  tag. 

Surge  gain  (deg/m).  This  value  should  be  0.0. 

Sway  gain  (deg/m).  This  value  should  be  0.0. 

Heave  gain  (deg/m).  This  value  is  typically  0.0. 

Roll  gain  (deg/deg).  This  value  is  typically  0.0  unless  rudder  roll 
stabilization  is  desired. 


pitchGain 

yawGain 


Note: 


Pitch  gain  (deg/deg).  This  value  is  typically  0.0. 

Yaw  gain  (deg/deg).  Note  that  the  input  yaw  gain  is  defined 
according  to  ship  motions  in  earth-fixed  axes,  for  which  positive 
yaw  motion  is  clockwise.  For  a  typical  ship  with  a  downward 
oriented  rudder,  this  value  is  typically  <  0.0. 

If  this  record  is  not  included  after  Record  (7a),  then  the  original 
values  for  the  given  ship  rudder  autopilot  are  used. 
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Record  (7d),  Rudder  Velocity  Gains 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a). 

“velGains”,  surge VelGain,  swayVelGain,  heave VelGain,  rollVelGain, 
pitchVelGain,  yaw  VelGain  (1  character  string,  6  floats) 


“velGains” 
surge  VelGain 
swayVelGain 
heave  VelGain 
rollVelGain 


Record  tag. 

Surge  velocity  gain  (deg/ (m/s)).  This  value  should  be  0.0. 

Sway  velocity  gain  (deg/ (m/s)).  This  value  should  be  0.0. 

Heave  velocity  gain  (deg/ (m/s)).  This  value  is  typically  0.0. 

Roll  velocity  gain  (deg/ (deg/s)).  This  value  is  typically  0.0  unless 
rudder  stabilization  is  desired. 


pitchVelGain  Pitch  velocity  gain  (deg/ (deg/s)).  This  value  is  typically  0.0. 

yaw  VelGain  Yaw  velocity  gain  (deg/(deg/s)).  Note  that  the  input  yaw  gain  is 

defined  according  to  ship  motions  in  earth-fixed  axes,  for  which 
positive  yaw  motion  is  clockwise.  For  a  typical  ship  with  a 
downward  oriented  rudder,  this  value  is  typically  <  0.0. 


Note:  If  this  record  is  not  included  after  Record  (7a),  then  the  original 

values  for  the  given  ship  rudder  autopilot  are  used. 


Record  (7e),  End  of  Rudder  Autopilot  Settings 

“end  rudderAutopilotSettings”  (2  character  strings) 


Record  (8),  Beginning  of  Azimuthing  Propeller  Force  Slopes 

Records  (8)  to  (8c)  are  required  if  the  ship  has  azimuthing  propellers, 
“begin  aziPropellerForceSlopes”  (2  character  strings) 


Record  (8a),  Key  of  Azimuthing  Propeller  for  Force  Slopes 

Records  (8a)  to  (8b)  are  required  for  each  azimuthing  propeller. 
“keyAziPropellcr”  keyAziPropellcr  (2  character  strings) 
“keyAziPropellcr”  Record  tag. 
keyAziPropellcr  Key  of  azimuthing  propeller. 
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Record  (8b),  Ship  Speed  and  Azimuthing  Propeller  Force  Slopes 

This  record  can  be  repeated  an  arbitrary  number  of  times  after  Record  (8a). 
Note  that  ship  speeds  must  be  in  ascending  order. 


“aziPropcllerForceSlopes” ,  speedAziPropeller,  swayForceDeflectSlopeDeg, 
heaveForceDeflectSlopeDeg  (1  character  string,  3  floats) 


“aziPropellerForceSlopes” 


Record  tag. 


speedAziPropeller 


Ship  speed  (m/s)  corresponding  to  force  slopes. 


swayForceDeflectSlopeDeg  Sway  force  deflection  slope  8F2/d5  (N/deg)  for 

azimuthing  propeller.  For  a  typical  downward 
pointing  azimuthing  propeller  (dihedral  angle  of 
—90°),  this  value  will  be  negative. 


heaveForceDeflectSlopeDeg  Heave  force  deflection  slope  dF3/d5  (N/deg)  for 

azimuthing  propeller.  For  a  typical  downward 
pointing  azimuthing  propeller  (dihedral  angle  of 
—90°),  this  value  will  be  approximately  0.0. 


Note: 


The  above  required  input  terms  are  given  in  the 
output  from  SM3DBuildShip3. 


Record  (8c),  End  of  Azimuthing  Propeller  Force  Slopes 

This  record  is  required  if  the  ship  has  azimuthing  propellers. 

“end  aziPropellerForceSlopes”  (2  character  strings) 

Record  (9),  Beginning  of  Azimuthing  Propeller  Deflection  Controller 

Settings 

Records  (9)  to  (9e)  are  optional. 

“begin  aziPropellerDeflectControllerSettings”  (2  character  strings) 

Note:  Records  (9)  to  (9e)  are  optional  and  can  be  used  to  supersede  autopilot 
settings  for  a  ship  defined  by  SM3DBuildShip3  given  in  the  file  of  Record 
(4).  Within  Records  (9)  to  (9e),  Records  (9a)  to  (9d)  can  be  repeated  an 
arbitrary  number  of  times  to  set  azimuthing  propeller  controller 
parameters  as  required. 
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Record  (9a),  Azimuthing  Propeller  Key  for  Controller  Settings 

This  record  must  follow  Record  (9)  if  controller  settings  are  being  given  as  input. 
“keyAziPropellcr”  keyAziPropellcr  (1  character  string,  1  integer) 
“keyAziPropeller”  Record  tag. 

keyAziPropellcr  Key  of  azimuthing  propeller  for  which  controller  settings  are 
being  specified.  If  this  key  to  set  to  “All” ,  then  the  input 
controller  settings  are  applied  to  all  azimuthing  propellers. 


Record  (9b),  Azimuthing  Propeller  Deflection  Controller  Parameters 

This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (9a) 

“deflect ControlParam” ,  deflectMaxDeg,  deflect VelMaxDeg,  deflectAccMaxDeg, 
deflectFreqResponse,  deflectDampResponse,  deflectDtMax  (1  character  string,  6 
floats) 


“deflect ControlParam”  Record  tag. 

deflectMaxDeg  Maximum  deflection  angle  (deg).  This  value  is  typically 

set  to  35°. 


deflect  VelMaxDeg  Maximum  deflection  velocity  (deg/s).  If  this  value  is  set 

to  0.0,  then  the  maximum  velocity  is  unlimited. 

deflectAccMaxDeg  Maximum  deflection  acceleration  (deg/s2).  If  this  value 

is  set  to  0.0,  then  the  maximum  acceleration  is 
unlimited. 


deflectFreqResponse  Undamped  response  frequency  of  deflection  controller. 

deflectDampResponse  Damping  of  deflection  controller  as  a  fraction  of  critical 

damping.  This  value  is  typically  between  0.5  and  1.0. 


deflectDtMax  Maximum  time  increment  for  time  stepping  of 

azimuthing  propeller  deflections.  This  parameter  doesn’t 
affect  frequency  domain  computations  with 
SM3DSeakeepRandom3. 

Note:  If  this  record  is  not  included  after  Record  (9a),  then  the 

original  values  for  the  given  azimuthing  propeller 
controller  are  used. 
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Record  (9c),  Azimuthing  Propeller  Deflection  Controller  Displacement 
Gains 


This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (9a) 

“deflectDispGains” ,  surgeGain,  swayGain,  heaveGain,  rollGain,  pitchGain, 
yawGain  (1  character  string,  6  floats) 

“deflectDispGains”  Record  tag. 


surgeGain 

Surge  gain  (deg/m).  This  value  should  be  0.0. 

swayGain 

Sway  gain  (deg/m).  This  value  should  be  0.0. 

heaveGain 

Heave  gain  (deg/m).  This  value  is  typically  0.0. 

rollGain 

Roll  gain  (deg/deg).  This  value  is  typically  0.0  unless  roll 
stabilization  is  desired. 

pitchGain 

Pitch  gain  (deg/deg).  This  value  is  typically  0.0. 

yawGain 

Yaw  gain  (deg/deg).  Note  that  the  input  yaw  gain  is  defined 
according  to  ship  motions  in  earth-fixed  axes,  for  which 
positive  yaw  motion  is  clockwise.  For  a  ship  using  a 
downward  oriented  azimuthing  propeller  for  course  keeping, 
this  value  is  typically  <  0.0. 

Note: 

If  this  record  is  not  included  after  Record  (9a),  then  the 
original  values  for  the  given  azimuthing  propeller  controller 
are  used. 
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Record  (9d),  Azimuthing  Propeller  Deflection  Controller  Velocity  Gains 

This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (9a) 

“deflect VelGains” ,  surge VelGain,  swayVelGain,  heave VelGain,  rollVelGain, 
pitchVelGain,  yaw  VelGain  (1  character  string,  6  floats) 


“deflect  VelGains” 
surge  VelGain 
swayVelGain 
heave  VelGain 
rollVelGain 


Record  tag. 

Surge  velocity  gain  (deg/ (m/s)).  This  value  should  be  0.0. 

Sway  velocity  gain  (deg/ (m/s)).  This  value  should  be  0.0. 

Heave  velocity  gain  (deg/ (m/s)).  This  value  is  typically  0.0 

Roll  velocity  gain  (deg/ (deg/s)).  This  value  is  typically  0.0 
unless  stabilization  is  desired. 


pitchVelGain 

yawVelGain 


Note: 


Pitch  velocity  gain  (deg/ (deg/s)).  This  value  is  typically  0.0. 

Yaw  velocity  gain  (deg/ (deg/s)).  Note  that  the  input  yaw 
gain  is  defined  according  to  ship  motions  in  earth-fixed  axes, 
for  which  positive  yaw  motion  is  clockwise.  For  a  ship  using  a 
downward  oriented  azimuthing  propeller  for  course  keeping, 
this  value  is  typically  <  0.0. 

If  this  record  is  not  included  after  Record  (9a),  then  the 
original  values  for  the  given  azimuthing  propeller  controller 
are  used. 


Record  (9e),  End  of  Azimuthing  Propeller  Controller  Settings 

“end  aziPropellcrDeflectControllerSettings”  (2  character  strings) 
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Record  (10),  Output  Options  for  Parameters  in  Regular  Seas 

“outRaoOptions” ,  outMotionRaoOption,  outRudderRaoOption, 
outAziPropRaoOption,  outUTubeTankRaoOption,  outRollDampOption 
outPositionRaoOption,  outWaveKinRaoOption  (8  character  strings) 


“outRaoOptions” 

Record  tag. 

outMotionRaoOption 

Option  for  writing  motion  RAOs: 

MotionRao  -  Ship  motion  RAOs  are  written  to 
output. 

NoMotionRao  -  Ship  motion  RAOs  are  not  written. 

outRudderRaoOption 

Option  for  writing  rudder  deflection  RAOs: 
RudderRao  -  Rudder  deflection  RAOs  are  written. 
NoRudderRao  -  Rudder  deflection  RAOs  are  not 
written. 

outAziPropRaoOption 

Option  for  writing  azimuthing  propeller  deflections: 
AziPropRao  -  Azimuthing  propeller  deflections  are 
written  to  output. 

NoAziPropRao  -  Azimuthing  propeller  deflections  are 
not  written  to  output. 

outUTubeTankRaoOption 

Option  for  writing  U-tube  tank  fluid  displacements: 
UTubeTankRao  -  U-tube  tank  fluid  displacements 
are  written  to  output. 

NoUTubeTankRao  -  U-tube  tank  fluid  displacements 
are  not  written  to  output. 

outRollDampOption 

Option  for  writing  roll  damping  values: 

RollDamp  -  Roll  damping  coefficients  are  written. 
NoRollDamp  -  Roll  damping  coefficients  are  not 
written. 

outPositionRaoOption 

Option  for  writing  seakeeping  position  RAOs: 
PositionRao  -  Seakeeping  positions  RAOs  are 
written. 

NoPositionRao  -  Seakeeping  positions  RAOs  are  not 
written. 

outWaveKinRaoOption 

Option  for  writing  wave  kinematics  RAOs: 
WaveKinRao  -  Wave  kinematics  RAOs  are  written. 
NoWaveKinRao  -  Wave  kinematics  RAOs  are  not 
written. 
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Record  (11),  Option  for  Output  Post-Processing  File  with  Motion  and 
Deflection  Response  Amplitude  Operators 

“outMoDefRaoPprOption” ,  outMoDefRaoPprOption  (2  character  strings) 
“outMoDefRaoPprOption”  Record  tag. 

outMoDefRaoPprOption  Option  for  output  of  data  file  with  motion  and 

appendage  deflections  response  amplitude  operators 
for  post-processing.  This  hie  is  a 
MotionDeflectRaoDB  object  in  .NET  binary 
serialization  format. 

MoDefRaoPpr  -  Motion  and  appendage  deflection 
RAOs  are  written  to  a  hie  in  .NET  binary  format. 

NoMoDefRaoRaoPpr  -  Motion  RAOs  are  not 
written  to  a  hie  in  .NET  binary  format. 

Record  (11a),  Output  Motion  and  Deflection  Response  Amplitude  Op¬ 
erator  File  Name 

This  record  should  only  be  given  if  outMoDefRaoPprOption  in  Record  (11)  is  set 
to  MoDefRaoPpr. 

“moDefRaoPprFileName”,  moDefRaoPprFileName  (2  character  strings) 
“moDefRaoPprFileName”  Record  tag. 

moDefRaoPprFileName  Name  of  output  hie  for  motion  and  appendage 

deflection  response  amplitude  operators  in  .NET 
binary  format. 
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Record  (12),  Option  for  Output  Post-Processing  File  with  Motions  and 
Deflections  in  Random  Seas 

“outMoDefRandomPprOption” ,  outMoDefRandomPprOption  (2  character 
strings) 

“outMoDefRandomPprOption”  Record  tag. 

outMoDefRandomPprOption  Option  for  output  of  data  file  with  RMS  and 

zero-crossing  periods  for  ship  motions  and 
appendage  deflections.  This  hie  is  a 
MotionDeflectRmsTzRandomDB  object  in 
.NET  binary  serialization  format. 

MoDefRandomPpr  -  RMS  and  zero-crossing 
period  values  for  ship  motions  and  appendage 
deflections  are  written  to  a  hie  in  .NET  binary 
format. 

NoMoDefRandomPpr  -  RMS  ship  motions  and 
appendage  deflections  are  not  written  to  a  hie 
in  .NET  binary  format. 


Record  (12a),  Output  Motion  in  Random  Seas  File  Name 

This  record  should  only  be  given  if  outMoDefRandomPprOption  in  Record  (12) 
is  set  to  MoDefRandomPpr. 

“moDefRandomPprFileName” ,  moDefRandomPprFileName  (2  character  strings) 
“moDefRandomPprFileName”  Record  tag. 

moDefRandomPprFileName  Name  of  output  hie  for  RMS  values  and 

zero-crossing  periods  in  .NET  binary  format. 
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Record  (13),  Option  for  Output  Post-Processing  File  of  Response  Am¬ 
plitude  Operators  SHIPM07  Format 

This  record  is  optional. 

“outSHIPM07PprOption”,  outSHIPM07Ppr0ption  (2  character  strings) 
“outSHIPM07PprOption”  Record  tag. 

outSHIPM07PprOption  Option  for  output  of  data  Hie  with  motion  response 

amplitude  operators  in  SHIPM07  ASCII 
post-processing  format.  This  file  can  be  used  for 
operability  analysis  using  SHIP0P2  ([18]). 

SHIPM07Ppr  -  Ship  motion  RAOs  are  written  in 
SHIPM07  ASCII  post-processing  format. 

NoSHIPM07Ppr  -  Ship  motion  RAOs  are  not 
written  in  SHIPM07  ASCII  post-processing  format. 

Record  (13a),  Output  Motion  in  Random  Seas  File  Name 

This  record  should  only  be  given  if  outSHIPM07PprOption  in  Record  (13)  is  set 
to  SHIPM07Ppr. 

“SHIPM07PprFileName”,  SHIPM07PprFileName  (2  character  strings) 
“SHIPM07PprFileName”  Record  tag. 

SHIPMO 7PprF ileName  Name  of  output  file  for  in  SHIPM07  ASCII 

post-processing  format. 

Record  (14),  Minimum  Wave  Encounter  Frequency 

“enFreqMinMotion” ,  enFreqMinMotion  (1  character  string,  1  float) 
“enFreqMinMotion”  Record  tag. 

enFreqMinMotion  Minimum  wave  encounter  frequency  for  ship  motion 

predictions.  If  the  combination  of  ship  speed,  heading,  and 
wave  frequency  gives  an  encounter  frequency  less  than  this 
value,  then  the  wave  frequency  is  shifted.  This  variable  is 
used  to  avoid  large  amplitude  motions  at  very  low 
encounter  frequencies.  A  value  of  approximately  0.3a Jg/L 
is  recommended. 
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Record  (15a),  Ship  Speed  Range  in  m/s 

One  of  Records  (15a)  to  (15f)  must  be  given. 

“speedRange” ,  speedMin,  speedMax,  speedlnc  (1  character  string,  3  floats) 

“speedRange”  Record  tag. 

speedMin  Minimum  ship  speed  (m/s). 

speedMax  Maximum  ship  speed  (m/s). 

speedlnc  Increment  for  ship  speed  (m/s). 

Record  (15b),  Ship  Speeds  in  m/s 

One  of  Records  (15a)  to  (15f)  must  be  given. 

“speeds”,  speeds  (1  character  string,  array  of  floats) 

“speeds”  Record  tag. 

speeds  Array  of  ship  speeds  (m/s). 

Record  (15c),  Ship  Speed  Range  in  Knots 

One  of  Records  (15a)  to  (15f)  must  be  given. 

“speedKnotsRange” ,  speedKnotsMin,  speedKnotsMax,  speedKnotsInc  (1 
character  string,  3  floats) 

“speedKnotsRange”  Record  tag. 

speedKnotsMin  Minimum  ship  speed  (knots). 

speedKnotsMax  Maximum  ship  speed  (knots). 

speedKnotsInc  Increment  for  ship  speed  (knots). 

Record  (15d),  Ship  Speeds  in  Knots 

One  of  Records  (15a)  to  (15f)  must  be  given. 

“speedsKnots” ,  speedsKnots  (1  character  string,  array  of  floats) 

“speedsKnots”  Record  tag. 

speedsKnots  Array  of  ship  speeds  (knots). 
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Record  (15e),  Froude  Number  Range 

One  of  Records  (15a)  to  (15f)  must  be  given. 

“FroudeRange” ,  froudeMin,  froudeMax,  froudelnc  (1  character  string,  3  floats) 

“FroudeRange”  Record  tag. 

froudeMin  Minimum  Froude  number. 

froudeMax  Maximum  Froude  number. 

froudelnc  Froude  number  increment. 

Record  (15f),  Ship  Froude  Numbers 

One  of  Records  (15a)  to  (15f)  must  be  given. 

“Froudes”,  froudes  (1  character  string,  array  of  floats) 

“Froudes”  Record  tag. 

froudes  Array  of  ship  Froude  numbers. 

Record  (16a),  Range  of  Sea  Directions  Relative  to  the  Ship  for  Com¬ 
puting  Motion  RAOs 

One  of  Records  (16a)  or  (16b)  must  be  given. 

“seaDirDegRange”,  seaDirDegMin,  seaDirDegMax,  seaDirDeglnc  (1  character 
string,  3  floats) 

“seaDirDegRange”  Record  tag. 

seaDirDegMin  Minimum  sea  direction  relative  to  ship  (deg). 

seaDirDegMax  Maximum  sea  direction  relative  to  ship  (deg). 

seaDirDeglnc  Increment  sea  direction  relative  to  ship  (deg). 

Record  (16b),  Sea  Directions  Relative  to  the  Ship  for  Computing  Mo¬ 
tion  RAOs 

One  of  Records  (16a)  or  (16b)  must  be  given. 

“seaDirsDeg” ,  seaDirsDeg  (1  character  string,  array  of  floats) 

“seaDirsDeg”  Record  tag. 

seaDirsDeg  Array  of  sea  directions  relative  to  the  ship  (deg)  . 
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Record  (17a),  Range  of  Sea  Directions  Relative  to  the  Ship  for  Seakeep¬ 
ing  Computations  in  Random  Seas 

One  of  Records  (17a)  or  (17b)  can  optionally  be  given. 

“seaDirDegRangeSeakeep” ,  seaDirDegSeakeepMin,  seaDirDegSeakeepMax, 
seaDirDegSeakeepInc  (1  character  string,  3  floats) 


“seaDirDegRangeSeakeep”  Record  tag. 

seaDirDegSeakeepMin  Minimum  sea  direction  relative  to  ship  (deg)  for 

seakeeping  computations  (deg). 


seaDirDegSeakeepMax 


seaDirDegSeakeepInc 


Note: 


Maximum  sea  direction  relative  to  ship  for 
seakeeping  computations  (deg). 

Increment  sea  direction  relative  to  ship  for 
seakeeping  computations  (deg). 

Either  Record  (17a)  or  (17b)  can  optionally  be  given 
as  input  to  specify  sea  directions  for  seakeeping 
computations.  If  neither  record  is  given,  then 
seakeeping  computations  are  performed  for  sea 
directions  specified  by  either  Record  (16a)  or  Record 
(16b). 


Record  (17b),  Sea  Directions  Relative  to  the  Ship  for  Seakeeping  Com¬ 
putations  in  Random  Seas 

One  of  Records  (17a)  or  (17b)  can  optionally  be  given. 

“seaDirsDegSeakeep” ,  seaDirsDegSeakeep  (1  character  string,  array  of  floats) 
“seaDirsDegSeakeep”  Record  tag. 

seaDirsDegSeakeep  Array  of  sea  directions  relative  to  the  ship  for  seakeeping 

computations  (deg)  . 

Note:  Either  Record  (17a)  or  (17b)  can  optionally  be  given  as 

input  to  specify  sea  directions  for  seakeeping 
computations.  If  neither  record  is  given,  then  seakeeping 
computations  are  performed  for  sea  directions  specified  by 
either  Record  (16a)  or  Record  (16b). 
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Record  (18a),  Range  of  Incident  Wave  Frequencies 

One  of  Records  (18a)  or  (18b)  must  be  given. 

“waveFreqRange” ,  waveFreqMin,  waveFreqMax,  waveFreqlnc  (1  character  string, 
3  floats) 

“waveFreqRange”  Record  tag. 

waveFreqMin  Minimum  incident  wave  frequency  (rad/s). 

waveFreqMax  Maximum  incident  wave  frequency  (rad/s). 

waveFreqlnc  Increment  for  incident  wave  frequency  (rad/s). 

Record  (18b),  Incident  Wave  Frequencies 

One  of  Records  (18a)  or  (18b)  must  be  given. 

“waveFreqs”,  waveFreqs  (1  character  string,  array  of  floats) 

“waveFreqs”  Record  tag. 

waveFreqs  Array  of  increasing  incident  wave  frequencies  (rad/s). 

Record  (19),  Wave  Spectrum  Option 

“spectrumOption” ,  spectrumOption  (2  character  strings) 

“spectrumOption”  Record  tag. 

spectrumOption  Wave  spectrum  option.  Options  are: 

Bretschneider  -  Bretschneider  spectrum. 

JONSWAP  -  JONSWAP  spectrum. 

OchiHubble  -  Six  parameter  Ochi  and  Hubble  spectrum. 
InputSpectrum  -  Input  spectral  densities. 

Record  (20a),  Parameters  for  Bretschneider  Spectrum 

This  record  is  required  if  spectrumOption  is  set  to  Bretschneider  in  Record  (19). 
“BretParam”,  hs,  tp  (1  character  string,  2  floats) 

“BretParam”  Record  tag. 
hs  Significant  wave  height  Hs  (m). 

tp  Peak  wave  period  Tp  (s). 
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Record  (20b),  Parameters  for  JONSWAP  Spectrum 

This  record  is  required  if  spectrumOption  is  set  to  JONSWAP  in  Record  (19). 

“JONSWAPParam”,  waveHeadingDeg,  hs,  tp,  peakEnhance  (1  character  string, 
3  floats) 

“JONSWAPParam”  Record  tag. 
hs  Significant  wave  height  Hs  (m). 

tp  Peak  wave  period  Tp  (s). 

peakEnhance  Peak  enhancement  factor  7.  This  factor  can  be  set  to  3.3 

to  match  a  2  parameter  JONSWAP  spectrum. 


Record  (20c),  Parameters  for  Ochi  and  Hubble  Six  Parameter  Spectrum 

This  record  is  required  if  spectrumOption  is  set  to  OchiHubble  in  Record  (19). 

“OchiHubbleParam”,  hsl,  freqPeakl,  spectralShapel,  hs2,  freqPeak2, 
spectralShape2  (1  character  string,  6  floats) 


“OchiHubbleParam” 

hsl 

freqPeakl 

spectralShapel 

hs2 

freqPeak2 

spectralShape2 


Record  tag. 

Significant  wave  height  hs_  1  of  wave  system  1  (m). 
Peak  wave  frequency  ujp-i  of  wave  system  1  (rad/s). 
Spectral  shape  factor  Ai  of  wave  system  1. 
Significant  wave  height  hs_2  of  wave  system  2  (m). 
Peak  wave  frequency  ojp-2  of  wave  system  2  (rad/s). 
Spectral  shape  factor  A2  of  wave  system  2. 


Record  (20dl),  Input  Spectrum  Wave  Frequencies 

This  record  is  required  if  spectrumOption  in  Record  (19)  is  set  to  InputSpectrum. 
“input WaveFreqs” ,  input  WaveFreqs  (1  character  string,  array  of  floats) 

“input WaveFreqs”  Record  tag. 

input  WaveFreqs  Wave  frequencies  u>i  for  input  energy  densities  (rad/s). 
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Record  (20d2),  Input  Spectrum  Energy  Densities 

This  record  is  required  if  spectrumOption  in  Record  (19)  is  set  to  InputSpectrum. 
“inputEnergyDensities” ,  inputEnergyDensities  (1  character  string,  array  of  floats) 
“inputEnergyDensities”  Record  tag. 

inputEnergyDensities  Wave  spectrum  energy  densities  SUi(uji)  corresponding 

to  wave  frequencies  of  Record  (20dl). 

Record  (21),  Directional  Spreading  Angle 

“spreadAngleDeg” ,  spreadAngleDeg  (1  character  string,  1  float) 

“spreadAngleDeg”  Record  tag. 

spreadAngleDeg  Directional  spreading  angle  6S  (degrees).  If  short-crested  seas 
are  being  modelled  (non- zero  spreading  angle),  then  the  sea 
directions  specified  by  Record  (16a)  or  (16b)  must  go  from  0 
to  180  degrees,  with  a  maximum  increment  of  30  degrees 
between  adjacent  sea  directions. 

Record  (22),  Beginning  of  Steady  Forward  Speed  Sinkage  and  Trim 
Data 

Records  (22)  to  (22b)  can  optionally  be  used  to  give  ship  sinkage  and  trim  data, 
“begin  steadySinkageTrim”  (1  character  string  with  2  words) 

Record  (22a),  Sinkage  and  Trim  for  Ship  Speed 

This  record  is  repeated  once  for  every  ship  speed  with  sinkage  and  trim  data, 
with  increasing  ship  speeds. 

“speedSinkageTrim” ,  speedSinkageTrim,  heaveSteady,  pitchSteadyDeg  (1 
character  string,  3  floats) 

“speedSinkageTrim”  Record  tag. 

speedSinkageTrim  Speed  for  which  sinkage  and  trim  values  are  given  (m/s) 
heaveSteady  Heave  at  steady  speed  (m,  +  up). 

pitchSteadyDeg  Pitch  at  steady  speed  (deg,  +  bow  down). 
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Record  (22b),  End  of  Steady  Sinkage  and  Trim  Data 

This  record  is  required  if  Records  (22)  and  (22a)  are  included. 

“end  steadySinkageTrim”  (1  character  string  with  2  words) 

Record  (23),  Beginning  of  Steady  Forward  Speed  Wave  Elevation  Data 

Records  (23)  to  (23d)  can  optionally  be  used  to  give  ship  steady  wave  profile  data 
data. 

“begin  steady WaveProfile”  (1  character  string  with  2  words) 

Record  (23a),  Stations  for  Steady  Wave  Elevation  Data 

This  record  is  required  if  steady  wave  elevation  data  are  being  given. 

“stationsSteadyWaveProfile” ,  stationsSteadyWaveProfile  (1  character  string, 
nStationSteady WaveProfile  floats) 

“stationsSteadyWaveProfile”  Record  tag. 

stationsSteadyWaveProfile  Ship  stations  for  steady  wave  elevation  data. 

Record  (23b),  Speeds  in  m/s  for  Steady  Wave  Elevation  Data 

This  record  is  required  if  steady  wave  elevation  data  are  being  given. 

“speedsSteady WaveProfile” ,  speedsSteadyWaveProfile  (1  character  string, 
nSpeedSteadyWaveProfile  floats) 

“speedsSteadyWaveProfile”  Record  tag. 

speedsSteadyWaveProfile  Ship  speeds  for  steady  wave  elevation  data  (m/s). 
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Record  (23c),  Steady  Wave  Elevation  Profile  Data 

This  record  must  be  given  for  each  station  with  steady  wave  elevation  data. 

“stationSteadyWaveElevs” ,  stationSteadyWave,  waveElevsSteady  (1  character 
string,  1  +  nSpeedSteadyWaveProfile  floats) 

“stationSteadyWaveElevs”  Record  tag. 

stationSteadyWave  Station  number  for  input  wave  elevations.  This 

value  must  be  consistent  with  values  given  in  Record 
(23a). 

waveElevsSteady  Wave  elevations  (m)  at  stationSteadyWave  for  ship 

speeds  specified  in  Record  (23b). 

Record  (23d),  End  of  Steady  Wave  stationSteadyWaveProfile  Data 

This  record  is  required  if  Record  (23)  and  subsequent  records  have  been  entered, 
“end  steady WaveProfile”  (1  character  string  with  2  words) 

Record  (24),  Beginning  of  Seakeeping  Position  Data 

This  record  is  optional. 

“begin  seakeepPositions”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (24a)  to  (24g6)  giving  seakeeping  position 
parameters.  Record  (24h)  must  follow  at  the  end  of  all  seakeeping 
position  data. 

Record  (24a),  Seakeeping  Position  Label 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 

“labelPos”,  labelPos  (2  character  strings) 

“labelPos”  Record  tag. 

labelPos  Label  for  seakeeping  position.  This  can  include  spaces. 
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Record  (24b),  Seakeeping  Position  Location 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 
“locationPos” ,  stationPos,  yPos,  zBIPos  (1  character  string,  3  floats) 
“locationPos”  Record  tag. 


stationPos 

Station  for  seakeeping  position.  Station  0  is  at  the  fore 
perpendicular. 

yPos 

Lateral  coordinate  (+  port)  relative  to  ship  centreline  (m). 

zBIPos 

Vertical  coordinate  (+  up)  relative  to  ship  baseline  (m). 

Record  (24c),  Option  Radiation  and  Diffraction  when  Evaluating  Rela¬ 
tive  Vertical  Motion 

This  record  is  optional  if  a  seakeeping  position  is  being  specified. 
“relMoRadDifOption”  relMoRadDifOption  (2  character  strings) 
“relMoRadDifOption”  Record  tag. 

relMoRadDifOption  Option  for  including  radiation  and  diffraction  in  relative 

vertical  motion: 

NoRadDif  -  Wave  radiation  and  diffraction  are  not 
considered  when  evaluating  relative  wave  motion 
(default). 
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Record  (24d),  Option  for  Including  the  Steady  Wave  Due  to  Ship  For¬ 
ward  Speed  when  Evaluating  Wetness  or  Emergence  Events 

This  record  is  optional  if  a  seakeeping  position  is  being  specified. 

“relWaveElevSteadyOption” ,  relWaveElevSteadyOption  (2  character  strings) 

“relWaveElevSteadyOptioiE  Record  tag. 

relWaveElevSteadyOption  Option  for  including  the  influence  of  the  steady 

wave  field  due  to  ship  forward  speed  when 
evaluating  distance  from  the  waterline  in  calm 
water: 

NoSteady Wave  -  The  steady  wave  due  to  ship 
forward  speed  is  not  included  (default).  This 
option  must  be  used  if  no  steady  wave  data  are 
provided  in  Records  (22)  to  (23d). 

SinkageTrimOnly  -  The  ship  sinkage  and  trim  due 
to  ship  forward  speed  are  included  when  evaluated 
vertical  position  relative  to  the  calm  waterline. 
Sinkage  and  trim  values  specified  in  input  Records 
(22)  to  (22b). 

SteadyWaveElev  -  The  steady  wave  elevation  is 
evaluated  based  on  steady  wave  profile  specified  in 
Records  (23)  to  (23d).  Sinkage  and  trim  from 
Records  (22)  to  (22b)  are  included. 

Record  (24e),  Option  for  Motion-Induced  Interruptions 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 

“miiOption” ,  miiOption  (2  character  strings) 

“miiOption”  Record  tag. 

miiOption  Option  for  motion-induced  interruption  computations: 

Mii  -  Motion-induced  interruption  computations  are  performed. 

NoMii  -  No  motion- induced  interruption  computations  are 
performed. 
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Record  (24el),  Parameters  for  Motion-Induced  Interruptions 

This  record  is  required  if  miiOption  is  set  to  mii  in  Record  (24e). 
“miiParam”,  tipCoLat,  tipCoLong,  durationMii  (1  character  strings,  3  floats) 


“miiParam” 

Record  tag. 

tipCoLat 

Lateral  tipping  coefficient.  A  value  of  0.25  is  typically  used  for 
humans  facing  forward. 

tipCoLong 

Longitudinal  tipping  coefficient.  A  value  of  0.17  is  typically  used 
for  humans  facing  forward. 

durationMii 

Duration  for  computing  incidence  of  motion-induced  interruptions 
(s).  A  value  of  60  s  is  typically  used. 

Note: 

For  sliding  calculations,  the  user  should  set  tipCoLat  and 
tipCoLong  equal  to  the  static  coefficient  of  friction. 

Record  (24f),  Option  for  Motion  Sickness  Incidence 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 
“motionSicknessOption” ,  motionSicknessOption  (2  character  strings) 
“motionSicknessOption”  Record  tag. 

motionSicknessOption  Option  for  motion  sickness  computations: 

MotionSickness  -  Motion  sickness  computations  are 
performed. 

NoMotionSickness  -  No  motion  sickness  computations 
are  performed. 

Record  (24fl),  Exposure  Time  for  Motion  Sickness  Incidence 

This  record  is  required  if  MotionSicknessOption  is  set  to  MotionSickness  in 
Record  (24f). 

“tD  ay  MotionSickness” ,  tDayMotionSickness  (1  character  strings,  1  float) 

“tD  ay  MotionSickness”  Record  tag. 

tDayMotionSickness  Exposure  time  at  which  motion  sickness  incidence  is 

computed  (days). 
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Record  (24g),  Option  for  Slamming,  Deck  Wetness,  or  Emergence  Com¬ 
putations 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 
“slamWetEmergeOption’' ,  slamWetEmergeOption  (2  character  strings) 
“slamWetEmergeOption”  Record  tag. 

slamWetEmergeOption  Option  for  slamming,  deck  wetness,  or  emergence 

computations: 

No  Slam  Wet  Emerge  -  No  slamming,  deck  wetness,  or 
emergence  computations  are  performed. 

SlamPressureCoWidth  -  Slamming  calculations  are 
performed  using  an  input  slamming  form  factor  and 
effective  pressure  width  specified  in  Record  (24g2). 

Slam  Wedge  -  Slamming  calculations  are  performed 
using  wedge  dimensions  given  in  Record  (24g3). 

SlamOffsets  -  Slamming  calculations  are  performed 
using  offsets  given  in  Records  (24g4),  (24g5),  and 
(24g6). 

WetnessEmerge  -  Incidence  of  wetness  or  emergence 
calculations  are  performed,  depending  on  whether  the 
position  is  above  or  below  the  waterline. 

Record  (24gl),  Duration  and  Exceedence  Probability  for  Slamming, 
Wetness,  or  Emergence  Statistics 

This  record  is  required  if  slamWetEmergeOption  in  Record  (21f)  is  set  to 
SlamPressureCoWidth,  Slam  Wedge,  SlamOffsets,  or  WetnessEmerge. 

“durationPExceed” ,  durationHours,  pExceed  (1  character  string,  2  floats) 

“durationPExceed”  Record  tag. 

durationHours  Duration  for  slamming,  wetness,  or  emergence  statistics 

(hours) . 

pExceed  Exceedence  probability  for  slamming,  wetness,  or  emergence 

statistics. 
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Record  (24g2),  Slamming  Pressure  Coefficient  and  Effective  Pressure 
Width 


This  record  is  required  if  slamWetEmergeOption  in  Record  (24g)  is  set  to 
SlamPressureCoWidth. 

“slamPressureCoWidth” ,  slamPressureCo,  slamForceWidth  (1  character  string,  2 
floats) 

“slamPressureCoWidth”  Record  tag. 

slamPressureCo  Slamming  pressure  coefficient. 

slamForceWidth  Effective  slamming  force  width  (m). 


Record  (24g3),  Wedge  Geometry  for  Slamming  Calculations 

This  record  is  required  if  slamWetEmergeOption  in  Record  (24g)  is  set  to 
Slam  Wedge. 

“slam Wedge”,  deadRiseDeg,  slamForceHeight  (1  character  string,  2  floats) 


“slamWedge”  Record  tag. 

deadRiseDeg  Hull  deadrise  angle  at  keel  (degrees).  This  value  must  be 

greater  than  0  degrees.  For  deadrise  angles  less  than  5  degrees, 
this  approach  can  be  inaccurate,  and  is  recommended  that 
either  the  slamForm  or  slamOffsets  option  be  used  instead  for 
slamWetEmergeOption  in  Record  (24g). 


slamForceHeight  Height  above  the  baseline  at  which  slamming  pressure  goes  to 
zero  (typically  taken  as  0.1TX,  where  Tx  is  the  sectional  draft 
of  the  keel). 


Record  (24g4),  Elevation  Above  Baseline  for  Zero  Slamming  Pressure 

This  record  is  required  if  slamWetEmergeOption  in  Record  (24g)  is  set  to 
SlamOffsets. 

“zBIZeroSlamPres” ,  zBIZeroSlamPres  (1  character  string,  1  floats) 
“zBIZeroSlamPres”  Record  tag. 

zBIZeroSlamPres  Elevation  above  baseline  at  which  slamming  pressure  goes  to 

zero  (m).  This  value  is  typically  assumed  to  be  at  a  height 
of  0.1TX  above  the  baseline,  where  Tx  is  sectional  draft. 
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Record  (24g5),  Y  Offsets  for  Performing  Slamming  Calculations 

This  record  is  required  if  slamWetEmergeOption  in  Record  (24g)  is  set  to 
SlamOffsets. 

“yOffsetsSlam” ,  yOffsetsSlam  (1  character  string,  array  of  floats) 

“yOffsetsSlam”  Record  tag. 

yOffsetsSlam  Horizontal  offsets  for  points  going  from  keel  to  at  least 

zBIZeroSlamPres  (Record  (24g4))  above  the  baseline  (m). 

Record  (24g6),  Z  Offsets  for  Performing  Slamming  Calculations 

This  record  is  required  if  slamWetEmergeOption  in  Record  (24g)  is  set  to 
SlamOffsets. 

“zBIOffsetsSlam” ,  zBIOffsetsSlam  (1  character  string,  array  of  floats) 
“zBIOffsetsSlam”  Record  tag. 

zBIOffsetsSlam  Vertical  offsets  for  points  going  from  keel  to  at  least 

zBIZeroSlamPres  (Record  (24g4))  above  the  baseline  (m). 

Record  (24h),  End  of  Seakeeping  Position  Data 

This  record  is  required  if  Record  (24)  is  present. 

“end  seakeepPositions”  (1  character  string  with  2  words) 

Record  (25),  Beginning  of  Wave  Kinematics  Position  Data 

This  record  is  optional. 

“begin  waveKinPositions”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (25a)  to  (25c)  giving  wave  kinematics  position 
parameters.  Record  (25d)  must  follow  at  the  end  of  wave  kinematics 
position  data. 
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Record  (25a),  Wave  Kinematics  Position  Label 

This  record  is  required  if  a  wave  kinematic  position  is  being  specified. 
“labelWaveKin”,  labelWaveKin  (2  character  strings) 

“labelWaveKin”  Record  tag. 

labelWaveKin  Label  for  wave  kinematic  position.  This  can  include  spaces. 


Record  (25bl),  Wave  Kinematics  Position  Station  and  Elevation  Rela¬ 
tive  to  Baseline 


One  of  Record  (25bl),  (25b2),  or  (25b3)  is  required  if  a  wave  kinematics  position 
is  being  specified. 


“stationYZBlWaveKin”,  stationWaveKin,  yWaveKin,  zBIWaveKin  (1  character 
string,  3  floats) 

“stationYZBlWaveKin”  Record  tag. 


stationWaveKin 


yWaveKin 


zBIWaveKin 


Station  for  wave  kinematic  position.  Station  0  is  at  the 
fore  perpendicular. 

Lateral  coordinate  (+  port)  relative  to  ship  centreline 

(m). 

Vertical  coordinate  (+  up)  relative  to  ship  baseline  (m). 
If  this  position  is  above  the  calm  waterline  for  the 
trimmed  ship,  then  it  is  moved  to  the  calm  waterline. 
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Record  (25b2),  Wave  Kinematics  Position  Station  and  Elevation  Rela¬ 
tive  to  Calm  Waterline 


One  of  Record  (25bl),  (25b2),  or  (25b3)  is  required  if  a  wave  kinematics  position 
is  being  specified. 


“stationYZWIWaveKin” ,  stationWaveKin,  yWaveKin,  zWIWaveKin  (1  character 
string,  3  floats) 


“stationYZWIWaveKin” 

stationWaveKin 

yWaveKin 

zWIWaveKin 


Record  tag. 

Station  for  wave  kinematic  position.  Station  0  is  at  the 
fore  perpendicular. 

Lateral  coordinate  (+  port)  relative  to  ship  centreline 
(m). 

Vertical  coordinate  (+  up)  relative  to  the  calm 
waterline  (m). 


Record  (25b3),  Wave  Kinematics  Position  X  Coordinate  and  Elevation 
Relative  to  Calm  Waterline 


One  of  Record  (25bl),  (25b2),  or  (25b3)  is  required  if  a  wave  kinematics  position 
is  being  specified. 

“xYZWIWaveKin” ,  xWaveKin,  yWaveKin,  zWIWaveKin  (1  character  string,  3 
floats) 

“xYZWIWaveKin”  Record  tag. 


xWaveKin 


yWaveKin 


x  coordinate  (+  forward,  relative  to  ship  CG)  for  wave 
kinematic  position  (m). 

Lateral  coordinate  (+  port)  relative  to  ship  centreline  (m). 


zWIWaveKin 


Vertical  coordinate  (+  up)  relative  to  the  calm  waterline 
(m). 
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Record  (25c),  Option  for  Including  Radiation  and  Diffraction  in  Wave 
Kinematics 

This  record  is  optional  if  a  wave  kinematics  position  is  being  specified. 
“waveKinRadDif7,  waveKinRadDifOption  (2  character  strings) 

“waveKinRadDif77  Record  tag. 

waveKinRadDifOption  Option  for  including  radiation  and  diffraction  in  wave 

kinematics: 

NoRadDif  -  Wave  radiation  and  diffraction  are  not 
considered  when  evaluating  wave  kinematics  (default). 

Record  (25d),  End  of  Wave  Kinematics  Position  Data 

This  record  is  required  if  Record  (25)  is  present 

“end  waveKinPositions”  (1  character  string  with  2  words) 

Record  (26),  Plot  Output  Option 

“plotOutOption” ,  plotOutOption  (2  character  strings) 

“plotOutOption”  Record  tag. 
plotOutOption  Option  for  making  plots: 

NoPlots  -  No  plots  are  produced. 

ScreenFile  -  Plots  are  both  plotted  on  the  screen  and  to  a  file. 
Screen  -  Plots  are  only  plotted  on  the  screen. 

File  -  Plots  are  only  written  to  a  file. 

Record  (27),  Beginning  of  Ship  Motion  RAO  Plot  Data 

This  record  is  optional. 

“begin  motionRaoPlots”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (27a)  to  (27h)  giving  plot  parameters.  Record 
(27i)  must  follow  at  the  end  of  plot  parameter  data. 
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Record  (27a),  Motion  RAO  Plot  Image  File  Name 

This  record  is  required  if  a  plot  is  being  specified. 

“imageFileName” ,  imageFileName  (2  character  strings) 

“imageFileName”  Record  tag. 
imageFileName  Name  of  output  plot  file. 

Record  (27b),  Motion  RAO  Plot  Image  Format 

This  record  is  optional  if  a  plot  is  being  specified. 

“imageFormat” ,  imageFormat  (2  character  strings) 

“imageFormat”  Record  tag. 

imageFormat  Plot  image  format.  Available  formats  are  png  (default)  and  jpg. 

Record  (27c),  Motion  RAO  Plot  Image  Size 

This  record  is  optional  if  a  plot  is  being  specified. 

“imageSize”,  widthmm,  heightmm  (1  character  string,  2  floats) 

“imageSize”  Record  tag. 

widthmm  Plot  width  (mm).  (Default  150  mm) 

heightmm  Plot  height  (mm).  (Default  200  mm) 

Record  (27dl),  Motion  RAO  Plot  Speed  in  m/s 

One  of  Records  (27dl),  (27d2),  or  (27d3)  is  required  for  each  plot  being  specified, 
“speed”,  speed  (1  character  string,  1  float) 

“speed”  Record  tag. 

speed  Ship  speed  (m/s)  for  plotted  RAOs.  This  speed  should  correspond  to  a 
speed  specified  for  computations  in  one  of  Records  (15a)  to  (15f). 
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Record  (27d2),  Motion  RAO  Plot  Speed  in  Knots 

One  of  Records  (27dl),  (27d2),  or  (27d3)  is  required  for  each  plot  being  specified. 
“speedKnots” ,  speedKnots  (1  character  string,  1  float) 

“speedKnots”  Record  tag. 

speedKnots  Ship  speed  (knots)  for  plotted  RAOs.  This  speed  must 

correspond  to  a  speed  specified  for  computations  in  one  of 
Records  (15a)  to  (15f ) . 

Record  (27d3),  Motion  RAO  Plot  Froude  Number 

One  of  Records  (27dl),  (27d2),  or  (27d3)  is  required  for  each  plot  being  specified. 
“Froude”,  Froude  (1  character  string,  1  float) 

“Froude”  Record  tag. 

Froude  Ship  forward  speed  Froude  number  for  plotted  RAOs.  This  speed 
should  correspond  to  a  speed  specified  for  computations  in  one  of 
Records  (15a)  to  (15f). 

Record  (27e),  Motion  RAO  Plot  Sea  Direction 

This  record  is  required  for  each  plot  being  specified. 

“seaDirDeg”,  seaDirDeg  (1  character  string,  1  float) 

“seaDirDeg”  Record  tag. 

seaDirDeg  Sea  direction  (deg)  relative  to  ship  for  plotted  RAOs.  This  sea 
direction  must  correspond  to  a  sea  direction  specified  for 
computations  Record  (16a)  or  (16b). 
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Record  (27f),  Option  for  Longitudinal  and/or  Lateral  Modes 

This  record  is  optional  if  a  plot  is  being  specified. 

“longLatOption”,  longLatOption  (2  character  strings) 
“longLatOption”  Record  tag. 


longLatOption 

Option  for  plotting  modes. 

LongLat  -  Longitudinal  and  lateral  and  inodes  will  be  shown 
with  longitudinal  inodes  in  the  left  column  and  lateral  modes 
in  the  right  column  (default). 

Long  -  Longitudinal  modes  will  be  shown  in  a  single  column. 

Lat  -  Lateral  modes  will  be  shown  in  a  single  column. 

Record  (27g),  Column  Options  for  Longitudinal  Modes 

This  record  is  optional  if  a  plot  is  being  specified. 

“longColumns” ,  surgeColnmn,  heaveColumn,  pitchColnmn  (3  character  strings) 
“longColumns”  Record  tag. 


surgeColnmn 

Values  for  each  of  the  following  can  be  one  of: 

Left 

Right 

Hide 

Column  of  surge  graph. 

heaveColumn 

Column  of  heave  graph. 

pitchColnmn 

Column  of  pitch  graph. 

Note: 

The  values  in  this  record  will  override  values  set  based  on 
longLatOption  in  Record  (21f). 
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Record  (27h),  Column  Options  for  Lateral  Modes 

This  record  is  optional  if  a  plot  is  being  specified. 

“latColumns”,  swayColnmn,  rollColumn,  yawColnmn,  deflectColumn  (5 
character  strings) 

“latColumns”  Record  tag. 

Values  for  each  of  the  following  can  be  one  of: 

Left 


swayColnmn 

rollColumn 

yawColnmn 

deflectColumn 

Note: 


Right 

Hide 

Column  of  sway  graph. 

Column  of  roll  graph. 

Column  of  yaw  graph. 

Column  of  graph  with  rudder  and/or  azimuthing  propeller 
deflection  angle  RAOs. 

The  values  in  this  record  will  override  values  set  based  on 
longLatOption  in  Record  (27f). 


Record  (27i),  End  of  Ship  Motion  RAO  Plot  Data 

“end  motionRaoPlots”  (1  character  string  with  2  words) 


Record  (28),  Beginning  of  Ship  Motion  in  Random  Seas  Plot  Data 

This  record  is  optional. 

“begin  mot ionRandomP lots”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (28a)  to  (28h)  giving  plot  parameters.  Record 
(28i)  must  follow  at  the  end  of  plot  parameter  data. 
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Record  (28a),  Motion  in  Random  Seas  Plot  Image  File  Name 

This  record  is  required  if  a  plot  is  being  specified. 

“imageFileName” ,  imageFileName  (2  character  strings) 

“imageFileName”  Record  tag. 
imageFileName  Name  of  output  plot  file. 

Record  (28b),  Motion  in  Random  Seas  Plot  Image  Format 

This  record  is  optional  if  a  plot  is  being  specified. 

“imageFormat” ,  imageFormat  (2  character  strings) 

“imageFormat”  Record  tag. 

imageFormat  Plot  image  format.  Available  formats  are  png  (default)  and  jpg. 

Record  (28c),  Motion  in  Random  Seas  Plot  Image  Size 

This  record  is  optional  if  a  plot  is  being  specified. 

“imageSize”,  widthmm,  heightmm  (1  character  string,  2  floats) 

“imageSize”  Record  tag. 

widthmm  Plot  width  (mm).  (Default  150  mm) 
heightmm  Plot  height  (mm).  (Default  200  mm) 

Record  (28dl),  Motion  in  Random  Seas  Speed  in  m/s 

One  of  Records  (28dl),  (28d2),  or  (28d3)  is  required  for  each  plot  being  specified, 
“speed”,  speed  (1  character  string,  1  float) 

“speed”  Record  tag. 

speed  Ship  speed  (m/s)  for  plotted  motions.  This  speed  must  correspond  to  a 
speed  specified  for  computations  in  one  of  Records  (15a)  to  (15f). 
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Record  (28d2),  Motion  in  Random  Seas  Speed  in  Knots 

One  of  Records  (28dl),  (28d2),  or  (28d3)  is  required  for  each  plot  being  specified. 
“speedKnots” ,  speedKnots  (1  character  string,  1  float) 

“speedKnots”  Record  tag. 

speedKnots  Ship  speed  (knots)  for  plotted  motions.  This  speed  must 
correspond  to  a  speed  specified  for  computations  in  one  of 
Records  (15a)  to  (15f). 

Record  (28d3),  Motion  in  Random  Seas  Froude  Number 

One  of  Records  (28dl),  (28d2),  or  (28d3)  is  required  for  each  plot  being  specified. 
“Froude”,  Froude  (1  character  string,  1  float) 

“Froude”  Record  tag. 

Froude  Ship  forward  speed  Froude  number  for  plotted  motions.  This  speed 
must  correspond  to  a  speed  specified  for  computations  in  one  of 
Records  (15a)  to  (15f). 

Record  (28e),  Motion  in  Random  Seas  RMS  or  Zero-Crossing  Period 
Option 

This  record  is  optional  if  a  plot  is  being  specified. 

“rmsTzOption” ,  rmsTzOption  (2  character  strings) 

“rmsTzOption”  Record  tag. 

rmsTzOption  Option  for  of  RMS  motions  or  zero-crossing  periods: 

Rms  -  RMS  motions  will  be  plotted  (default). 

Tz  -  Zero-crossing  periods  will  be  plotted. 
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Record  (28f),  Option  for  Longitudinal  and/or  Lateral  Modes 

This  record  is  optional  if  a  plot  is  being  specified. 

“longLatOption”,  longLatOption  (2  character  strings) 
“longLatOption”  Record  tag. 


longLatOption 

Option  for  plotting  modes: 

LongLat  -  Longitudinal  and  lateral  and  inodes  will  be  shown 
with  longitudinal  inodes  in  the  left  column  and  lateral  modes 
in  the  right  column  (default). 

Long  -  Longitudinal  modes  will  be  shown  in  a  single  column. 

Lat  -  Lateral  modes  will  be  shown  in  a  single  column. 

Record  (28g),  Column  Options  for  Longitudinal  Modes 

This  record  is  optional  if  a  plot  is  being  specified. 

“longColumns” ,  surgeColnmn,  heaveColumn,  pitchColnmn  (3  character  strings) 
“longColumns”  Record  tag. 


surgeColnmn 

Values  for  each  of  the  following  can  be  one  of: 

Left 

Right 

Hide 

Column  of  surge  graph. 

heaveColumn 

Column  of  heave  graph. 

pitchColnmn 

Column  of  pitch  graph. 

Note: 

The  values  in  this  record  will  override  values  set  based  on 
longLatOption  in  Record  (28f). 
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Record  (28h),  Column  Options  for  Lateral  Modes 

This  record  is  optional  if  a  plot  is  being  specified. 

“latColumns”,  swayColnmn,  rollColumn,  yawColnmn,  deflectColumn  (5 
character  strings) 

“latColumns”  Record  tag. 


swayColnmn 

Values  for  each  of  the  following  can  be  one  of: 

Left 

Right 

Hide 

Column  of  sway  graph. 

rollColumn 

Column  of  roll  graph. 

yawColnmn 

Column  of  yaw  graph. 

deflectColumn 

Column  of  graph  with  rudder  and/or  azimuthing  propeller 
deflection  angles. 

Note: 

The  values  in  this  record  will  override  values  set  based  on 
longLatOption  in  Record  (28f). 

Record  (28i),  End  of  Ship  Motion  in  Random  Seas  Plot  Data 

“end  motionRandomPlots”  (1  character  string  with  2  words) 

Record  (29),  End  Record 

“end  SM3DSeakeepRandom3”  (1  character  string  with  2  words) 
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D.2  Sample  Input  File  for  SM3DSeakeepRandom3 

begin  SM3DSeakeepRandora3 
label  Generic  frigate 

shipDBFileName  genFrigShipForMotionDB.bin 
lengthData  120.000  20.000 

loadCondition  1025.000  4.200  0.000  6.000  0.000 

outRaoOptions  NoMotionRao  NoRudderRao  NoAziPropRao  NoUTubeTankRao  ! 

NoRollDamp  NoPositionRao  NoWaveKinRao 
outMoDefRaoPprOption  MoDefRaoPpr 

raoDefRaoPprFileName  genFrigSeakeepRandomMoDefRaoDB.bin 
outMoDefRandomPprOption  MoDef RandomPpr 

raoDef RandomPprFileName  genFrigSeakeepRandomMoDef RandomDB . bin 
enFreqMinMotion  0.1 
speedKnotsRange  0  30  10 
seaDirDegRange  0  180  15 
waveFreqRange  0.2  2  0.05 
spectrumOption  Bretschneider 
BretParam  3.25  9.7 
spreadAngleDeg  0 
begin  seakeepPositions 
labelPos  Seakeeping  position 
locationPos  3  2  12 
relMoRadDif Option  NoRadDif 
relWaveElevSteadyOption  NoSteadyWave 
miiOption  Mii 
miiParam  0.25  0.17  60 
motionSicknessOption  MotionSickness 
tDayMotionSickness  0.25 
slamWetEmergeOption  WetnessEmerge 
durationPExceed  1  0.01 
end  seakeepPositions 
plotOutOption  NoPlots 
end  SM3DSeakeepRandora3 
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D.3  Sample  Output  File  for  SM3DSeakeepRandom3 
(Motions  Only  Given  for  One  Ship  Speed) 

Program  SM3DSeakeepRandom3 

ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Time  :  November-10-11  9:07:39  AM 
Run  label: 

Generic  frigate 

****  ECHO  OF  USER  INPUT  **** 


Input  ship  for  motion  database  file  name: 

genFrigShipForMotionDB . bin 

Label  :  Generic  frigate 

Created  :  November-09- 11  8:19:55  AM 

Version  :  ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Class  :  ShipMo3D . ShipForMotionDB 


Ship  Length  Data 

Length  between  perpendiculars  :  120.000  m 

Station  of  aft  perpendicular  :  20.000 


Ship  Loading  Condition 
Water  density  :  1025.000  kg/m3 
Draft  of  baseline  at  midships 
Trim  of  baseline  by  stern 
Height  of  CG  above  baseline,  KG 
Correction  to  metacentric  height  GM 


4.200  m 
0.000  m 
6.000  m 
0.000  m 


Options  for  Output  of  Response  Amplitude 
Output  motion  RAO  option  : 
Output  rudder  deflection  : 
Output  azimuthing  propeller  deflection  : 
Output  U-tube  tank  fluid  angle  : 
Output  roll  damping  option  : 
Output  seakeeping  position  option  : 
Output  wave  kinematics  option  : 


Operators  in  Long-crested  Seas 

NoMotionRao 

NoRudderRao 

NoAziPropRao 

NoUTubeTankRao 

NoRollDamp 

NoPositionRao 

NoWaveKinRao 


Output  motion  and  deflection  RAO  post-processing  file  option  :  MoDefRaoPpr 
File  name  with  motion  RAOs  for  post-processing  : 
genFrigSeakeepRandomMoDef RaoDB .bin 

Output  RMS  motion  post -processing  file  option  :  MoDefRandomPpr 
File  name  with  RMS  motions  for  post-processing  : 
genFrigSeakeepRandomMoDef RandomDB . bin 

Minimum  wave  encounter  frequency  for  predicting  ship  motions  :  0.100  rad/s 
Speed  range 

Minimum  :  0.000  knots 
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Maximum  : 
Increment  : 


30.000  knots 
10.000  knots 


Sea  direction  range 


Minimum  :  0.000  deg 
Maximum  :  180.000  deg 
Increment  :  15.000  deg 


Minimum 


Incident  wave  frequency  range 


Minimum 

Maximum 


0.200  rad/s 
2 . 000  rad/ s 


Increment  :  0.050  rad/s 


Seaway 

Spectrum  option  : 

Bretschneider  spectrum  parameters 


Significant  wave  height 
Peak  wave  period 
Wave  spreading  angle 


0.0  deg 


3.250  m 
9.700  s 


Seakeeping  Positions 


Label 

Station 

Lateral  offset  y 
Vertical  offset  zBl 


Seakeeping  position 
3.000 

2.000  m  (+  port) 

12.000  m  (+  up,  relative  to  baseline) 


Option  for  including  radiation  and  diffraction  for  relative  motion  :  NoRadDif 

(input) 

Option  for  including  steady  wave  due  to  ship  forward  speed  :  NoSteadyWave  (input) 

Option  for  motion-induced  interruption  computations  :  Mii 

Parameters  for  mot ion- induced  interruptions 

Lateral  tipping  coefficient  :  0.250 

Longitudinal  tipping  coefficient  :  0.170 

Duration  for  Mil  incidence  :  60.0  s 

Option  for  motion  sickness  computations  :  MotionSickness 

Parameters  for  motion  sickness 

Exposure  time  :  0.250  days 

Option  for  slamming,  wetness,  or  emergence  computations  :  WetnessEmerge 
Parameters  for  slamming,  wetness  or  emergence  statistics 
Duration  :  1.000  hours 

Exceedence  probability  :  0.010000 

Output  plot  option  :  NoPlots 

****  SHIP  LOADING  CONDITION  **** 

Load  Condition  Properties  for  Trimmed  Ship 

Summary  of  hydrostatic  properties 

Number  of  panels  on  port  side  :  613 

Total  number  of  panels  :  1226 
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Length,  between  perpendiculars 
Draft  of  baseline  at  midships 
Trim  of  baseline  by  stern 
Beam  based  on  maximum  y  value 
Volume 

Water  density 
Mass 

Distance  from  FP  to  X  origin  (m) 
(Origin  located  at  LCG) 

Station  of  X  origin 
Center  of  buoyancy  wrt  waterline 
Wetted  surface  area 
Waterplane  area 

X  value  of  center  of  floatation 
Integral  of  waterplane  area*X**2 
Integral  of  waterplane  area*Y**2 
KG,  height  of  CG  above  baseline 
Height  of  CG  above  waterline 
Metacentric  height  from  hydrostatics 


120.000  m 
4.200  m 
0.000  m 
14.111  m 
3622.358  m3 
1025.000  kg/m3 
3712916.723463  kg 
61.750  m 

10.292 
-1.614  m 
1753.438  m2 
1344.310  m2 
-5.022  m 
1234204.219  m4 
17543.814  m4 
6 . 000  m 
1.800  m 
1.430  m 


Inertial  Properties 


Inertia  matrix,  units  of  kg,  kg*m,  and  kg*m2 


3712916.7 

0.0 

0.0 

0.0 

3712916.7 

0.0 

0.0 

0.0 

3712916.7 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

Roll  radius  of  gyration  : 

4.800  m 

Pitch  radius 

of  gyration  : 

30.000  m 

Yaw  radius  of 

gyration  : 

30.000  m 

0, 

.0 

0. 

,0 

0, 

,0 

0, 

.0 

0. 

,0 

0. 

,0 

0, 

.0 

0. 

,0 

0. 

,0 

85545601, 

.3 

0. 

,0 

0, 

,0 

0, 

.0 

3341625051. 

,1 

0, 

,0 

0, 

.0 

0. 

,0 

3341625051, 

,1 

Roll  Metacentric  Height  Properities 


)Roll  metacentric  height  from  hull  hydrostatics  : 
Correction  due  to  sloshing  tanks  : 

Input  correction  to  roll  metacentric  height  : 
Corrected  metacentric  height  : 


1.430  m 
0.000  m 
0.000  m 
1.430  m 


Roll  Properties  at  Zero  Forward  Speed 


Roll  added  mass 

Nondimensional  roll  added  mass  A44/I44 
Natural  roll  frequency 
Natural  roll  period 


19548240.530169  kg*m**2 
0.229 

0.704  rad/s 
8.928  s 


****  SHIP  AUTOPILOT  SETTINGS  **** 
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Rudder  Autopilots  for  Ship 


Autopilot  for  ship  with  nominally  steady  speed  and  heading 
Key  :  Rudder 
Label  :  Rudder 
Maximum  deflection 
Maximum  velocity 
Maximum  acceleration 
Response  frequency 
Response  damping 
Maximum  time  step 
Autopilot  gains 

Displacement  gains  have  units  of  deg/m  and  deg/deg 
Velocity  gains  have  units  of  deg/ (m/s)  and  deg/ (deg/s) 

Yaw  gains  given  relative  to  earth-fixed  axes  (+yaw  is  clockwise) 


35.000  deg 
3.000  deg/s 
Not  set  deg/s2 
3.000  rad/s 

0.850  rad/s  (fraction  of  critical) 
0.100  s 


Displacement  gains 
Velocity  gains 


Surge 

0.000 

0.000 


Sway 

0.000 

0.000 


Heave 

0.000 

0.000 


Roll 

0.000 

0.000 


Pitch 

0.000 

0.000 


Yaw 

-4.000 

-8.000 


****  SEAKEEPING  POSITION  TRIM  CONDITIONS  **** 


Label 
Station 
x  wrt  ship  CG 


Seakeeping  position 
3.000 
43.750  m 


z  wrt  baseline 
z  wrt  ship  CG 
z  wrt  waterline 


2.000  m 
12.000  m 
6.000  m 
7.800  m 


Parameters  for  mot ion- induced  interruptions 
Lateral  tipping  coefficient  :  0.250 

Longitudinal  tipping  coefficient  :  0.170 

Time  of  operation  :  60.000 

Parameters  motion  sickness 
Time  for  motion  sickness  : 


s 

0.250  days 


****  WAVE  SPECTRUM  **** 

Bretschneider  spectrum 
Significant  wave  height  :  3.250  m 

Peak  wave  period  :  9.700  m 

Long-crested  seaway 

Significant  wave  height  based  on  point  wave  spectrum  area  : 


Wave  frequency 
(rad/s) 

0.200 

0.250 


Spectral  density 
m2/ (rad/s) 
0.000 
0.000 


3.228  m 
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0.300 

0.350 

0.400 

0.450 

0.500 

0.550 

0.600 

0.650 

0.700 

0.750 

0.800 

0.850 

0.900 

0.950 

1.000 

1.050 

1.100 

1.150 

1.200 

1.250 

1.300 

1.350 

1.400 

1.450 

1.500 

1.550 

1.600 

1.650 

1.700 

1.750 

1.800 

1.850 

1.900 

1.950 

2.000 


0.000 

0.000 

0.010 

0.147 

0.549 

1.040 

1.365 

1.457 

1.380 

1.219 

1.034 

0.857 

0.702 

0.572 

0.465 

0.379 

0.310 

0.254 

0.210 

0.174 

0.145 

0.121 

0.102 

0.086 

0.073 

0.062 

0.053 

0.046 

0.040 

0.035 

0.030 

0.026 

0.023 

0.020 

0.018 
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Motions  at  Ship  CG  in  a  Random  Seaway  **** 
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Rudder 

direction  Deflection  Tz 

(deg)  (s) 

0.0  0.00  45.1 


15.0  2.83  32.7 
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Annex  E:  Files  for  Motions  in  an  Earth-Fixed 
Seaway  with  SM3DSeakeepSeaway3 

E.1  Format  of  Input  File  for  SM3DSeakeepSeaway3 

Record  (1),  Beginning  Record 

“begin  SM3DSeakeepSeaway3”  (1  character  string  with  2  words) 

Record  (2),  Run  Label 

“label” ,  label  (2  character  strings) 

“label”  Record  tag. 

label  Label  for  run.  This  can  include  spaces. 

Record  (3),  Beginning  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

“begin  note”  (1  character  string  with  2  words) 

Record  (3a),  Note 

noteText  (character  string) 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

noteText  Text  of  note.  Multiple  lines  can  be  entered. 

Record  (3b),  End  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

“end  note”  (1  character  string  with  2  words) 
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Record  (4),  Input  Ship  Database  File  Name 

“shipDBFileName” ,  shipDBFileName  (2  character  strings) 

“shipDBFileName”  Record  tag. 

shipDBFileName  Name  of  input  ship  database  hie  (ShipForMotionDB  object) 

in  .NET  binary  serialization  format.  This  hie  must  have 
been  created  using  program  SM3DBuildShip3. 


Record  (5),  Length  Data 

“lengthData” ,  lpp,  stationAP  (1  character  string,  2  boats) 

“lengthData”  Record  tag. 

lpp  Ship  length  between  perpendiculars  (m). 

stationAP  Station  number  of  the  aft  perpendicular.  This  value  is  typically 


20.0 


Note:  The  values  in  this  record  must  agree  with  the  values  used  for  the 

ship  database  hie  specihed  in  Record  (4).  Values  are  considered 
to  be  in  agreement  when  they  are  within  a  tolerance  of  0.001  m 
for  length,  and  0.001  for  the  station  of  the  aft  perpendicular.  The 
output  hie  from  SM3DBuildShip3  gives  the  values  of  the  above 
parameters. 
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Record  (6),  Ship  Loading  Condition 

“loadCondition” ,  waterDensity,  draftBIMid,  trimBIStern,  shipKG,  correctionGM 
(1  character  string,  5  floats) 


“loadCondition” 

waterDensity 

draftBIMid 

trimBIStern 

shipKG 

correctionGM 


Record  tag. 

Water  density  (kg/m3). 

Draft  of  baseline  at  midships  (m). 

Trim  of  baseline  by  stern  (m). 

Height  of  centre  of  gravity  above  baseline  (m). 
Correction  to  metacentric  height  (m). 


Note:  The  values  in  this  record  must  agree  with  the  values  used  for 

the  ship  database  file  specified  in  Record  (4).  Values  are 
considered  to  be  in  agreement  when  they  are  within  a  tolerance 
of  0.001  kg/m3  for  density,  and  0.001  m  for  draft,  trim,  height 
of  CG,  and  metacentric  height.  The  output  file  from 
SM3DBuildShip3  gives  the  values  of  the  above  parameters. 


Record  (7),  Beginning  of  Rudder  Autopilot  Settings. 

Records  (7)  to  (7e)  are  optional. 

“begin  rudderAutopilotSettings”  (2  character  strings) 

Note:  Records  (7)  to  (7e)  are  optional  and  can  be  used  to  supersede  autopilot 
settings  for  a  ship  defined  by  SM3DBuildShip3  given  in  the  file  of  (4). 
Within  Records  (7)  to  (7e),  Records  (7a)  to  (7d)  can  be  repeated  an 
arbitrary  number  of  times  to  set  rudder  autopilot  parameters  as  required. 


Record  (7a),  Rudder  Key  for  Autopilot  Settings 

This  Record  must  follow  Record  (7)  if  autopilot  settings  are  being  given  as  input. 
“keyRudder”  keyRudder  (2  character  strings) 

“keyRudder”  Record  tag. 

keyRudder  Key  of  rudder  for  which  autopilot  settings  are  being  specified.  If 
the  rudder  key  is  set  to  “All” ,  then  the  input  autopilot  settings 
are  applied  to  all  rudders. 
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Record  (7b),  Rudder  Autopilot  Control  Parameters 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a). 

“controlParam” ,  deflectMaxDeg,  velMaxDeg,  accMaxDeg,  freqResponse, 
dampResponse,  dtMax  (1  character  string,  6  floats) 

“controlParam”  Record  tag. 


deflectMaxDeg 

Maximum  rudder  deflection  angle  (deg).  This  value  is  typically 
set  to  35°. 

velMaxDeg 

Maximum  rudder  deflection  velocity  (deg/s).  If  this  value  is  set 
to  0.0,  then  the  maximum  velocity  is  unlimited. 

accMaxDeg 

Maximum  rudder  acceleration  (deg/s2).  If  this  value  is  set  to 
0.0,  then  the  maximum  acceleration  is  unlimited. 

freqResponse 

Undamped  response  frequency  of  rudder  autopilot. 

dampResponse 

Damping  of  rudder  autopilot  as  a  fraction  of  critical  damping. 
This  value  is  typically  between  0.5  and  1.0 

dtMax 

Maximum  time  increment  for  time  stepping  of  rudder  motions. 
This  parameter  doesn’t  affect  frequency  domain  computations 
with  SM3DSeakeepSeaway. 

Note: 

If  this  record  is  not  included  after  Record  (7a),  then  the 
original  values  for  the  given  ship  rudder  autopilot  are  used. 
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Record  (Tc),  Rudder  Autopilot  Displacement  Gains 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a). 

“dispGains”,  surgeGain,  swayGain,  heaveGain,  rollGain,  pitchGain,  yawGain  (1 
character  string,  6  floats) 


“dispGains” 

surgeGain 

swayGain 

heaveGain 

rollGain 


Record  tag. 

Surge  gain  (deg/m).  This  value  should  be  0.0. 

Sway  gain  (deg/m).  This  value  should  be  0.0. 

Heave  gain  (deg/m).  This  value  is  typically  0.0. 

Roll  gain  (deg/deg).  This  value  is  typically  0.0  unless  rudder  roll 
stabilization  is  desired. 


pitchGain 

yawGain 


Note: 


Pitch  gain  (deg/deg).  This  value  is  typically  0.0. 

Yaw  gain  (deg/deg).  Note  that  the  input  yaw  gain  is  defined 
according  to  ship  motions  in  earth-fixed  axes,  for  which  positive 
yaw  motion  is  clockwise.  For  a  typical  ship  with  a  downward 
oriented  rudder,  this  value  is  typically  <  0.0. 

If  this  record  is  not  included  after  Record  (7a),  then  the  original 
values  for  the  given  ship  rudder  autopilot  are  used. 
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Record  (7d),  Rudder  Velocity  Gains. 

This  record  can  optionally  be  entered  if  an  autopilot  key  has  been  specified  using 
Record  (7a) 

“velGains”,  surge VelGain,  swayVelGain,  heave VelGain,  rollVelGain, 
pitchVelGain,  yaw  VelGain  (1  character  string,  6  floats) 


“velGains” 
surge  VelGain 
swayVelGain 
heave  VelGain 
rollVelGain 


Record  tag. 

Surge  velocity  gain  (deg/ (m/s)).  This  value  should  be  0.0. 

Sway  velocity  gain  (deg/ (m/s)).  This  value  should  be  0.0. 

Heave  velocity  gain  (deg/ (m/s)).  This  value  is  typically  0.0. 

Roll  velocity  gain  (deg/ (deg/s)).  This  value  is  typically  0.0  unless 
rudder  stabilization  is  desired. 


pitchVelGain  Pitch  velocity  gain  (deg/ (deg/s)).  This  value  is  typically  0.0. 

yaw  VelGain  Yaw  velocity  gain  (deg/(deg/s)).  Note  that  the  input  yaw  gain  is 

defined  according  to  ship  motions  in  earth-fixed  axes,  for  which 
positive  yaw  motion  is  clockwise.  For  a  typical  ship  with  a 
downward  oriented  rudder,  this  value  is  typically  <  0.0. 


Note:  If  this  record  is  not  included  after  Record  (7a),  then  the  original 

values  for  the  given  ship  rudder  autopilot  are  used. 


Record  (7e),  End  of  Rudder  Autopilot  Settings 

“end  rudderAutopilotSettings”  (2  character  strings) 


Record  (8),  Beginning  of  Azimuthing  Propeller  Force  Slopes 

Records  (8)  to  (8c)  are  required  if  the  ship  has  azimuthing  propellers, 
“begin  aziPropellerForceSlopes”  (2  character  strings) 


Record  (8a),  Key  of  Azimuthing  Propeller  for  Force  Slopes 

Records  (8a)  to  (8b)  are  required  for  each  azimuthing  propeller. 
“keyAziPropellcr”  keyAziPropellcr  (2  character  strings) 
“keyAziPropellcr”  Record  tag. 
keyAziPropellcr  Key  of  azimuthing  propeller. 
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Record  (8b),  Ship  Speed  and  Azimuthing  Propeller  Force  Slopes 

This  record  can  be  repeated  an  arbitrary  number  of  times  after  Record  (8a). 
Note  that  ship  speeds  must  be  in  ascending  order. 


“aziPropcllerForceSlopes” ,  speedAziPropeller,  swayForceDeflectSlopeDeg, 
heaveForceDeflectSlopeDeg  (1  character  string,  3  floats) 


“aziPropellerForceSlopes” 


Record  tag. 


speedAziPropeller 


Ship  speed  (m/s)  corresponding  to  force  slopes. 


swayForceDeflectSlopeDeg  Sway  force  deflection  slope  8F2/d5  (N/deg)  for 

azimuthing  propeller.  For  a  typical  downward 
pointing  azimuthing  propeller  (dihedral  angle  of 
—90°),  this  value  will  be  negative. 


heaveForceDeflectSlopeDeg  Heave  force  deflection  slope  dF3/d5  (N/deg)  for 

azimuthing  propeller.  For  a  typical  downward 
pointing  azimuthing  propeller  (dihedral  angle  of 
—90°),  this  value  will  be  approximately  0.0. 


Note: 


The  above  required  input  terms  are  given  in  the 
output  from  SM3DBuildShip3. 


Record  (8c),  End  of  Azimuthing  Propeller  Force  Slopes 

This  record  is  required  if  the  ship  has  azimuthing  propellers. 

“end  aziPropellerForceSlopes”  (2  character  strings) 

Record  (9),  Beginning  of  Azimuthing  Propeller  Deflection  Controller 

Settings 

Records  (9)  to  (9e)  are  optional. 

“begin  aziPropellerDeflectControllerSettings”  (2  character  strings) 

Note:  Records  (9)  to  (9e)  are  optional  and  can  be  used  to  supersede  autopilot 
settings  for  a  ship  defined  by  SM3DBuildShip3  given  in  the  file  of  Record 
(4).  Within  Records  (9)  to  (9e),  Records  (9a)  to  (9d)  can  be  repeated  an 
arbitrary  number  of  times  to  set  azimuthing  propeller  controller 
parameters  as  required. 
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Record  (9a),  Azimuthing  Propeller  Key  for  Controller  Settings 

This  record  must  follow  Record  (9)  if  controller  settings  are  being  given  as  input. 
“keyAziPropellcr”  keyAziPropellcr  (1  character  string,  1  integer) 
“keyAziPropeller”  Record  tag. 

keyAziPropellcr  Key  of  azimuthing  propeller  for  which  controller  settings  are 
being  specified.  If  this  key  to  set  to  “All” ,  then  the  input 
controller  settings  are  applied  to  all  azimuthing  propellers. 


Record  (9b),  Azimuthing  Propeller  Deflection  Controller  Parameters 

This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (9a). 

“deflect  ControlParam” ,  deflectMaxDeg,  deflect  VelMaxDeg,  deflectAccMaxDeg, 
deflectFreqResponse,  deflectDampResponse,  dtMax  (1  character  string,  6  floats) 


“deflect ControlParam”  Record  tag. 

deflectMaxDeg  Maximum  deflection  angle  (deg).  This  value  is  typically 

set  to  35°. 


deflect  VelMaxDeg  Maximum  deflection  velocity  (deg/s).  If  this  value  is  set 

to  0.0,  then  the  maximum  velocity  is  unlimited. 

deflectAccMaxDeg  Maximum  deflection  acceleration  (deg/s2).  If  this  value 

is  set  to  0.0,  then  the  maximum  acceleration  is 
unlimited. 


deflectFreqResponse  Undamped  response  frequency  of  deflection  controller. 

deflectDampResponse  Damping  of  deflection  controller  as  a  fraction  of  critical 

damping.  This  value  is  typically  between  0.5  and  1.0. 


deflectDtMax  Maximum  time  increment  for  time  stepping  of 

azimuthing  propeller  deflections.  This  parameter  doesn’t 
affect  frequency  domain  computations  with 
SM3DSeakeepSeaway. 

Note:  If  this  record  is  not  included  after  Record  (9a),  then  the 

original  values  for  the  given  azimuthing  propeller 
controller  are  used. 
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Record  (9c),  Azimuthing  Propeller  Deflection  Controller  Displacement 
Gains 


This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (9a) 

“deflectDispGains” ,  surgeGain,  swayGain,  heaveGain,  rollGain,  pitchGain, 
yawGain  (1  character  string,  6  floats) 

“deflectDispGains”  Record  tag. 


surgeGain 

Surge  gain  (deg/m).  This  value  should  be  0.0. 

swayGain 

Sway  gain  (deg/m).  This  value  should  be  0.0. 

heaveGain 

Heave  gain  (deg/m).  This  value  is  typically  0.0. 

rollGain 

Roll  gain  (deg/deg).  This  value  is  typically  0.0  unless  roll 
stabilization  is  desired. 

pitchGain 

Pitch  gain  (deg/deg).  This  value  is  typically  0.0. 

yawGain 

Yaw  gain  (deg/deg).  Note  that  the  input  yaw  gain  is  defined 
according  to  ship  motions  in  earth-fixed  axes,  for  which 
positive  yaw  motion  is  clockwise.  For  a  ship  using  a 
downward  oriented  azimuthing  propeller  for  course  keeping, 
this  value  is  typically  <  0.0. 

Note: 

If  this  record  is  not  included  after  Record  (9a),  then  the 
original  values  for  the  given  azimuthing  propeller  controller 
are  used. 
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Record  (9d),  Azimuthing  Propeller  Deflection  Controller  Velocity  Gains 

This  record  can  optionally  be  entered  if  an  azimuthing  propeller  controller  key 
has  been  specified  using  Record  (9a). 

“deflect  VelGains” ,  surge  VelGain,  swayVelGain,  heave VelGain,  rollVelGain, 
pitchVelGain,  yaw  VelGain  (1  character  string,  6  floats) 


“deflect  VelGains” 
surge  VelGain 
swayVelGain 
heave  VelGain 
rollVelGain 


Record  tag. 

Surge  velocity  gain  (deg/ (m/s)).  This  value  should  be  0.0. 

Sway  velocity  gain  (deg/ (m/s)).  This  value  should  be  0.0. 

Heave  velocity  gain  (deg/ (m/s)).  This  value  is  typically  0.0 

Roll  velocity  gain  (deg/(deg/s)).  This  value  is  typically  0.0 
unless  stabilization  is  desired. 


pitchVelGain 

yawVelGain 


Note: 


Pitch  velocity  gain  (deg/ (deg/s)).  This  value  is  typically  0.0. 

Yaw  velocity  gain  (deg/ (deg/s)).  Note  that  the  input  yaw 
gain  is  defined  according  to  ship  motions  in  earth-fixed  axes, 
for  which  positive  yaw  motion  is  clockwise.  For  a  ship  using  a 
downward  oriented  azimuthing  propeller  for  course  keeping, 
this  value  is  typically  <  0.0. 

If  this  record  is  not  included  after  Record  (9a),  then  the 
original  values  for  the  given  azimuthing  propeller  controller 
are  used. 


Record  (9e),  End  of  Azimuthing  Propeller  Controller  Settings 

“end  aziPropellcrDeflectControllerSettings”  (2  character  strings) 


Record  (10),  Minimum  Wave  Encounter  Frequency 

“enFreqMinMotion” ,  enFreqMinMotion  (1  character  string,  1  float) 
“enFreqMinMotion”  Record  tag. 

enFreqMinMotion  Minimum  wave  encounter  frequency  for  ship  motion 

predictions.  If  the  combination  of  ship  speed,  heading,  and 
wave  frequency  gives  an  encounter  frequency  less  than  this 
value,  then  the  wave  frequency  is  shifted.  This  variable  is 
used  to  avoid  large  amplitude  motions  at  very  low 
encounter  frequencies.  A  value  of  approximately  0.3 \fgjL 
is  recommended. 
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Record  (11a),  Ship  Speed  Range  in  m/s 

One  of  Records  (11a)  to  (Ilf)  must  be  given. 

“speedRange” ,  speedMin,  speedMax,  speedlnc  (1  character  string,  3  floats) 

“speedRange”  Record  tag. 

speedMin  Minimum  ship  speed  (m/s). 

speedMax  Maximum  ship  speed  (m/s). 

speedlnc  Increment  for  ship  speed  (m/s). 

Record  (lib),  Ship  Speeds  in  m/s 

One  of  Records  (11a)  to  (Ilf)  must  be  given. 

“speeds”,  speeds  (1  character  string,  array  of  floats) 

“speeds”  Record  tag. 

speeds  Array  of  ship  speeds  (m/s). 

Record  (11c),  Ship  Speed  Range  in  Knots 

One  of  Records  (11a)  to  (Ilf)  must  be  given. 

“speedKnotsRange” ,  speedKnotsMin,  speedKnotsMax,  speedKnotsInc  (1 
character  string,  3  floats) 

“speedKnotsRange”  Record  tag. 

speedKnotsMin  Minimum  ship  speed  (knots). 

speedKnotsMax  Maximum  ship  speed  (knots). 

speedKnotsInc  Increment  for  ship  speed  (knots). 

Record  (lid),  Ship  Speeds  in  Knots 

One  of  Records  (11a)  to  (Ilf)  must  be  given. 

“speedsKnots” ,  speedsKnots  (1  character  string,  array  of  floats) 

“speedsKnots”  Record  tag. 

speedsKnots  Array  of  ship  speeds  (knots). 
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Record  (He),  Froude  Number  Range 

One  of  Records  (11a)  to  (Ilf)  must  be  given. 

“FroudeRange” ,  froudeMin,  froudeMax,  froudelnc  (1  character  string,  3  floats) 

“FroudeRange”  Record  tag. 

froudeMin  Minimum  Froude  number. 

froudeMax  Maximum  Froude  number. 

froudelnc  Froude  number  increment. 


Record  (Ilf),  Ship  Froude  Numbers 

One  of  Records  (11a)  to  (Ilf)  must  be  given. 
“Froudes”,  froudes  (1  character  string,  array  of  floats) 
“Froudes”  Record  tag. 
froudes  Array  of  ship  Froude  numbers. 


Record  (12a),  Range  of  Ship  Fleadings 

One  of  Records  (12a)  or  (12b)  must  be  given. 

“shipHeadingRange” ,  shipHeadingDegMin,  shipHeadingDegMax, 
shipHeadingDeglnc  (1  character  string,  3  floats) 


“shipHeadingRange” 

shipHeadingDegMin 

shipHeadingDegMax 

shipHeadingDeglnc 

Note: 


Record  tag. 

Minimum  ship  heading  (to,  deg). 

Maximum  ship  heading  (to,  deg). 

Increment  for  ship  heading  (to,  deg). 

The  ship  heading  convention  is  0°  for  the  ship  heading 
north,  90°  for  the  ship  heading  east. 
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Record  (12b),  Ship  Headings 

One  of  Records  (12a)  or  (12b)  must  be  given. 

“shipHeadingsDeg” ,  shipHeadingsDeg  (1  character  string,  array  of  floats) 
“shipHeadingsDeg”  Record  tag. 

shipHeadingsDeg  Array  of  ship  headings  (deg).  The  ship  heading  convention 

is  0°  for  the  ship  heading  north,  90°  for  the  ship  heading 
east. 

Record  (13),  Seaway  Option 

“spectrumOption” ,  spectrumOption  (2  character  strings) 

“spectrumOption”  Record  tag. 

spectrumOption  Type  of  seaway. 

UniSpectrum  -  Unidirectional  seaway  based  on  input 
spectrum. 

CosSpectrum  -  Directional  spectrum  describe  by  a  point 
wave  spectrum  and  cosine-squared  spreading  function. 

DirSpectrum  -  Directional  seaway  with  specified  directional 
properties. 

Record  (14),  Beginning  of  Unidirectional  Wave  Spectrum 

Records  (14)  to  (14d)  are  required  if  spectrumOption  is  set  to  UniSpectrum  in 
Record  (13). 

“begin  UniSpectrum”  (1  character  string  with  2  words) 

Record  (14a),  Wave  Heading 

This  record  is  required  if  seawayOption  in  Record  (13)  is  set  to  UniSpectrum. 
“waveHeading” ,  waveHeadingFromDeg  (1  character  string,  1  float) 
“waveHeading”  Record  tag. 

waveHeadingFromDeg  Wave  direction  v  (from,  degrees).  0°  for  waves  from 

north,  and  90°  for  waves  from  east. 
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Record  (14b),  Unidirectional  Wave  Spectrum  Option 

This  record  is  required  if  spectrumOption  in  Record  (13)  is  set  to  UniSpectrum. 
“uniSpectrumOption” ,  uniSpectrumOption  (2  character  strings) 
“uniSpectrumOption”  Record  tag. 

uniSpectrumOption  Type  of  unidirectional  wave  spectrum. 

Bretschneider  -  Unidirectional  Bretschneider  wave 
spectrum. 

JONSWAP  -  Unidirectional  JONSWAP  wave  spectrum. 

OchiHubble  -  Unidirectional  Ochi  and  Hubble  six 
parameter  wave  spectrum. 

Input  -  Unidirectional  user-input  wave  spectrum. 

Record  (14cl),  Unidirectional  Bretschneider  Spectrum  Seaway  Param¬ 
eters 

This  record  is  required  if  uniSpectrumOption  in  Record  (14b)  is  set  to 
Bretschneider. 

“BretParam”,  hs,  tp  (1  character  string,  2  floats) 

“BretParam”  Record  tag. 
hs  Significant  wave  height  Hs  (m). 

tp  Peak  wave  period  Tp  (s). 

Record  (14c2),  Unidirectional  JONSWAP  Spectrum  Seaway  Parame¬ 
ters 

This  record  is  required  if  uniSpectrumOption  in  Record  (14b)  is  set  to 
JONSWAP. 

“JONSWAPParam”,  hs,  tp,  peakEnhance  (1  character  string,  3  floats) 
“JONSWAPParam”  Record  tag. 
hs  Significant  wave  height  Hs  (m). 

tp  Peak  wave  period  Tp  (s). 

peakEnhance  Peak  enhancement  factor  7.  This  factor  can  be  set  to  3.3 

to  match  a  2  parameter  JONSWAP  spectrum. 


220 


DRDC  Atlantic  TM  2011-308 


Record  (14c3),  Unidirectional  Ochi  Hubble  Spectrum  Parameters 

This  record  is  required  if  uniSpectrumOption  in  Record  (14b)  is  set  to 
OchiHubble. 

“OchiHubbleParam”,  hsl,  freqPeakl,  spectralShapel,  hs2,  freqPeak2, 
spectralShape2  (1  character  string,  6  floats) 

“OchiHubbleParam”  Record  tag. 


hsl 

freqPeakl 

spectralShapel 

hs2 

freqPeak2 

spectralShape2 


Significant  wave  height  hs_ i  of  wave  system  1  (m). 
Peak  wave  frequency  ujp-i  of  wave  system  1  (rad/s). 
Spectral  shape  factor  Ai  of  wave  system  1. 
Significant  wave  height  hs_2  of  wave  system  2  (m). 
Peak  wave  frequency  ojp-2  of  wave  system  2  (rad/s). 
Spectral  shape  factor  A2  of  wave  system  2. 


Record  (14c4),  Unidirectional  Input  Spectrum  Wave  Frequencies 

This  record  is  required  if  uniSpectrumOption  in  Record  (14b)  is  set  to  Input, 
“input WaveFreqs” ,  input WaveFreqs  (1  character  string,  array  of  floats) 

“input WaveFreqs”  Record  tag. 

input  WaveFreqs  Wave  frequencies  u>i  for  input  energy  densities  (rad/s). 

Record  (14c5),  Unidirectional  Input  Spectrum  Energy  Densities 

This  record  is  required  if  uniSpectrumOption  in  Record  (14b)  is  set  to  Input 
“inputEnergyDensities” ,  inputEnergyDensities  (1  character  string,  array  of  floats) 
“inputEnergyDensities”  Record  tag. 

inputEnergyDensities  Wave  spectrum  energy  densities  SUl(coj)  corresponding 

to  wave  frequencies  of  Record  (14c4). 

Record  (14d),  End  of  Unidirectional  Wave  Spectrum 

This  record  is  required  if  spectrumOption  is  set  to  UniSpectrum  in  Record  (13). 
“end  uniSpectrum”  (1  character  string  with  2  words) 
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Record  (15),  Beginning  of  Cosine-squared  Spreading  Wave  Spectrum 

Records  (15)  to  (15d)  are  required  if  spectrumOption  is  set  to  CosSpectrum  in 
Record  (13). 

“begin  cosSpectrum”  (1  character  string  with  2  words) 

Record  (15a),  Mean  Wave  Heading 

This  record  is  required  if  seawayOption  in  Record  (13)  is  set  to  CosSpectrum. 
“waveHeadingMean” ,  waveHeadingMeanDeg  (1  character  string,  1  float) 
“waveHeadingMean”  Record  tag. 

waveHeadingMeanDeg  Mean  wave  direction  v  (from,  degrees).  0°  for  waves 

from  north,  and  90°  for  waves  from  east. 

Record  (15b),  Wave  Spreading  Angle 

This  record  is  required  if  spectrumOption  in  Record  (13)  is  set  to  CosSpectrum. 
“spreadAngle” ,  spreadAngleDeg  (1  character  string,  1  float) 

“spreadAngle”  Record  tag. 

spreadAngleDeg  Directional  spreading  angle  (deg). 

Record  (15c),  Cosine-Squared  Wave  Spectrum  Option 

This  record  is  required  if  spectrumOption  in  Record  (13)  is  set  to  CosSpectrum. 
“cosSpectrumOption” ,  cosSpectrumOption  (2  character  strings) 
“cosSpectrumOption”  Record  tag. 

cosSpectrumOption  Type  of  wave  spectrum  with  cosine-squared  directional 

spreading: 

CosBretschneider  -  Bretschneider  wave  spectrum  with 
cosine-squared  directional  spreading. 

Cos  JONS  WAP  -  JONSWAP  wave  spectrum  with 
cosine-squared  directional  spreading. 
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Record  (15cl),  Cosine-squared  Bretschneider  Spectrum  Parameters 

This  record  is  required  if  cosSpectrumOption  in  Record  (15c)  is  set  to 
CosBretschneider . 

“BretParam”,  hs,  tp  (1  character  string,  2  floats) 

“BretParam”  Record  tag. 
hs  Significant  wave  height  Hs  (m). 

tp  Peak  wave  period  Tp  (s). 

Record  (15c2),  Cosine-squared  JONSWAP  Spectrum  Seaway  Parame¬ 
ters 

This  record  is  required  if  cosSpectrumOption  in  Record  (15c)  is  set  to 
CosJONSWAP. 

“JONSWAPParam”,  hs,  tp,  peakEnhance  (1  character  string,  3  floats) 
“JONSWAPParam”  Record  tag. 
hs  Significant  wave  height  Hs  (nr), 

tp  Peak  wave  period  Tp  (s). 

peakEnhance  Peak  enhancement  parameter  7.  This  factor  can  be  set  to 

3.3  to  match  a  2  parameter  JONSWAP  spectrum. 

Record  (15d),  End  of  Cosine-squared  Spreading  Wave  Spectrum 

This  record  is  required  if  spectrumOption  is  set  to  CosSpectrum  in  Record  (13). 
“end  cosSpectrum”  (1  character  string  with  2  words) 

Record  (16),  Beginning  of  Directional  Wave  Spectrum 

Records  (16)  to  (16d)  are  required  if  spectrumOption  is  set  to  DirSpectrum  in 
Record  (13). 

“begin  dirSpectrum”  (1  character  string  with  2  words) 
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Record  (16a),  Directional  Wave  Spectrum  Option 

This  record  is  required  if  spectrumOption  in  Record  (13)  is  set  to  DirSpectrum. 
“dirSpectrumOption” ,  dirSpectrumOption  (2  character  strings) 
“dirSpectrumOption”  Record  tag. 


dirSpectrumOption 

Type  of  unidirectional  wave  spectrum: 

TenParameter  -  Ten  parameter  spectrum  from  Hogben 
and  Cobb  [23]. 

EndecoWaveBuoy  -  Directional  spectrum  from  Endeco 
wave  buoy. 

InputDir  -  Input  directional  spectrum. 

Record  (16al),  Ten  Parameter  Spectrum  Parameters 

This  record  is  required  if  dirSpectrumOption  in  Record  (16a)  is  set  to 
TenParameter. 

“tenParamParam” ,  hsl,  freqPeakl,  spectralShapel,  waveHeadingMeanDegl, 
dirSpreadExpl,  hs2,  freqPeak2,  spectralShape2,  waveHeadingMeanDeg2, 
dirSpreadExp2  (1  character  string,  10  floats) 

“tenParamParam”  Record  tag. 


hsl 

Significant  wave  height  hs-\  of  wave  system  1  (m). 

freqPeakl 

Peak  wave  frequency  cup_i  of  wave  system  1  (rad/s). 

spectralShapel 

Spectral  shape  factor  Ai  of  wave  system  1. 

waveHeadingMeanDegl  Principle  wave  direction  zq  (from,  degrees)  of  wave 


dirSpreadExpl 

system  1.  0°  for  waves  from  north,  and  90°  for  waves 
from  east. 

Directional  spreading  exponent  P\  of  wave  system  1. 

hs2 

Significant  wave  height  hs_ 2  of  wave  system  2  (m). 

freqPeak2 

Peak  wave  frequency  cup_2  of  wave  system  2  (rad/s). 

spectralShape2 

Spectral  shape  factor  A2  of  wave  system  2. 

waveHeadingMeanDeg2  Principle  wave  direction  z/2  (from,  degrees)  of  wave 


dirSpreadExp2 

system  2.  0°  for  waves  from  north,  and  90°  for  waves 
from  east. 

Directional  spreading  exponent  P2  of  wave  system  2. 
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Record  (16b),  Endeco  Wave  Buoy  Spectrum  File  Name 

This  record  is  required  if  spectrumOption  in  Record  (13)  is  set  to 
EndecoWaveBuoy. 

“EndecoSpectrumFileName”,  EndecoSpectrumFileName  (2  character  strings) 
“EndecoSpectrumFileName”  Record  tag. 

EndecoSpectrumFileName  File  name  of  directional  wave  spectrum  file 

produced  by  Endeco  956  or  1156  wave  buoy.  The 
file  name  will  typically  have  the  extension  “.std”. 

Record  (16c),  Input  Directional  Wave  Spectrum  File  Name 

This  record  is  required  if  spectrumOption  in  Record  (13)  is  set  to  inputDir. 
“inputDirSpectrumFileName”,  inputDirSpectrumFileName  (2  character  strings) 
“inputDirSpectrumFileName”  Record  tag. 

inputDirSpectrumFileName  Input  directional  wave  spectrum  file  name.  The 

format  of  the  directional  wave  spectrum  file  is 
given  in  Annex  A. 2. 

Record  (16d),  End  of  Directional  Wave  Spectrum 

This  record  is  required  if  spectrumOption  is  set  to  DirSpectrum  in  Record  (13). 
“end  dir  Spectrum”  (1  character  string  with  2  words) 

Record  (17a),  Range  of  Incident  Wave  Frequencies  for  Integration  of 
Ship  Motion  Spectrum 

One  of  Records  (17a)  or  (17b)  must  be  given. 

“waveFreqRange” ,  waveFreqMin,  waveFreqMax,  waveFreqlnc  (1  character  string, 
3  floats) 

“waveFreqRange”  Record  tag. 

waveFreqMin  Minimum  incident  wave  frequency  (rad/s). 

waveFreqMax  Maximum  incident  wave  frequency  (rad/s). 

waveFreqlnc  Increment  for  incident  wave  frequency  (rad/s). 
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Record  (17b),  Incident  Wave  Frequencies  for  Integration  of  Ship  Motion 
Spectrum 

One  of  Records  (17a)  or  (17b)  must  be  given. 

“waveFreqs”,  waveFreqs  (1  character  string,  array  of  floats) 

“waveFreqs”  Record  tag. 

waveFreqs  Array  of  increasing  incident  wave  frequencies  (rad/s). 


Record  (18a),  Wave  Direction  Range  for  Integration  of  Ship  Motion 
Spectrum 

If  spectrumOption  in  Record  (13)  is  set  to  CosSpectrum  or  DirSpectrum,  then 
one  of  Records  (18a)  or  (18b)  must  be  given. 

“waveDirFromRange” ,  waveDirFromDegMin,  waveDirFromDegMax, 
waveDirFromDeglnc  (1  character  string,  3  floats) 


“waveDirFromRange” 

waveDirFromDegMin 


Record  tag. 

Minimum  wave  direction  (deg). 


waveDirFromDegMax  Maximum  wave  direction  (deg). 


waveDirFromDeglnc 

Note: 


Wave  direction  increment  (deg). 

Wave  directions  are  given  using  a  convention  of  0°  for 
waves  from  north,  90°  for  waves  from  east. 


Record  (18b),  Wave  Directions  Integration  of  Ship  Motion  Spectrum 

If  spectrumOption  in  Record  (13)  is  set  to  CosSpectrum  or  DirSpectrum,  then 
one  of  Records  (18a)  or  (18b)  must  be  given. 

“waveDirsFrom” ,  waveDirsFromDeg  (1  character  string,  array  of  floats) 
“waveDirsFrom”  Record  tag. 

waveDirsFromDeg  Wave  directions  for  integration  of  ship  motion  spectrum. 

Wave  directions  are  given  using  a  convention  of  0°  for  waves 
from  north,  90°  for  waves  from  east. 


Record  (19),  Beginning  of  Steady  Forward  Speed  Sinkage  and  Trim 
Data 

Records  (19)  to  (19b)  can  optionally  be  used  to  give  ship  sinkage  and  trim  data, 
“begin  steadySinkageTrim”  (1  character  string  with  2  words) 
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Record  (19a),  Sinkage  and  Trim  for  Ship  Speed 

This  record  is  repeated  once  for  every  ship  speed  with  sinkage  and  trim  data, 
with  increasing  ship  speeds. 

“speedSinkageTrim” ,  speedSinkageTrim,  heaveSteady,  pitchSteadyDeg  (1 
character  string,  3  floats) 

“speedSinkageTrim”  Record  tag. 

speedSinkageTrim  Speed  for  which  sinkage  and  trim  values  are  given  (m/s) 
heaveSteady  Heave  at  steady  speed  (m,  +  up). 

pitchSteadyDeg  Pitch  at  steady  speed  (deg,  +  bow  down). 

Record  (19b),  End  of  Steady  Sinkage  and  Trim  Data 

This  record  is  required  if  Records  (19)  and  (19a)  are  included. 

“end  steadySinkageTrim”  (1  character  string  with  2  words) 

Record  (20),  Beginning  of  Steady  Forward  Speed  Wave  Elevation  Data 

Records  (20)  to  (20d)  can  optionally  be  used  to  give  ship  steady  wave  profile  data 
data. 

“begin  steady WaveProfile”  (1  character  string  with  2  words) 

Record  (20a),  Stations  for  Steady  Wave  Elevation  Data 

This  record  is  required  if  steady  wave  elevation  data  are  being  given. 

“stationsSteadyWaveProfile” ,  stationsSteadyWaveProfile  (1  character  string, 
nStationSteady WaveProfile  floats) 

“stationsSteadyWaveProfile”  Record  tag. 

stationsSteadyWaveProfile  Ship  stations  for  steady  wave  elevation  data. 

Record  (20b),  Speeds  in  m/s  for  Steady  Wave  Elevation  Data 

This  record  is  required  if  steady  wave  elevation  data  are  being  given. 

“speedsSteady WaveProfile” ,  speedsSteadyWaveProfile  (1  character  string, 
nSpeedSteadyWaveProfile  floats) 

“speedsSteadyWaveProfile”  Record  tag. 

speedsSteadyWaveProfile  Ship  speeds  for  steady  wave  elevation  data  (m/s). 
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Record  (20c),  Steady  Wave  Elevation  Profile  Data 

This  record  must  be  given  for  each  station  with  steady  wave  elevation  data. 

“stationSteadyWaveElevs” ,  stationSteadyWave,  waveElevsSteady  (1  character 
string,  1  +  nSpeedSteadyWaveProfile  floats) 

“stationSteadyWaveElevs”  Record  tag. 

stationSteadyWave  Station  number  for  input  wave  elevations.  This 

value  must  be  consistent  with  values  given  in  Record 
(20a). 

waveElevsSteady  Wave  elevations  (m)  at  stationSteadyWave  for  ship 

speeds  specified  in  Record  (20b). 

Record  (20d),  End  of  Steady  Wave  Profile  Data 

This  record  is  required  if  Record  (20)  and  subsequent  records  have  been  entered, 
“end  steady WaveProfile”  (1  character  string  with  2  words) 

Record  (21),  Beginning  of  Seakeeping  Position  Data 

This  record  is  optional. 

“begin  seakeepPositions”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (21a)  to  (21f6)  giving  seakeeping  position 
parameters.  Record  (21g)  must  follow  at  the  end  of  all  seakeeping 
position  data. 

Record  (21a),  Seakeeping  Position  Label 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 

“labelPos”,  labelPos  (2  character  strings) 

“labelPos”  Record  tag. 

labelPos  Label  for  seakeeping  position.  This  can  include  spaces. 
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Record  (21b),  Seakeeping  Position  Location 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 

“locationPos” ,  stationPos,  yPos,  zBIPos  (1  character  string,  3  floats) 
“locationPos”  Record  tag. 

stationPos  Station  for  seakeeping  position.  Station  0  is  at  the  fore 
perpendicular. 

yPos  Lateral  coordinate  (+  port)  relative  to  ship  centreline  (nr). 

zBIPos  Vertical  coordinate  (+  up)  relative  to  ship  baseline  (nr). 

Record  (21c),  Option  for  Radiation  and  Diffraction  when  Evaluating 
Relative  Vertical  Motion 

This  record  is  optional  if  a  seakeeping  position  is  being  specified. 
“relMoRadDifOption”  relMoRadDifOption  (2  character  strings) 
“relMoRadDifOption”  Record  tag. 

relMoRadDifOption  Option  for  including  radiation  and  diffraction  in  relative 

vertical  motion: 

NoRadDif  -  Wave  radiation  and  diffraction  are  not 
considered  when  evaluating  relative  wave  motion 
(default). 
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Record  (21d),  Option  for  Including  the  Steady  Wave  Due  to  Ship  For¬ 
ward  Speed  when  Evaluating  Wetness  or  Emergence  Events 

This  record  is  optional  if  a  seakeeping  position  is  being  specified. 

“relWaveElevSteadyOption” ,  relWaveElevSteadyOption  (2  character  strings) 

“relWaveElevSteadyOptioiE  Record  tag. 

relWaveElevSteadyOption  Option  for  including  the  influence  of  the  steady 

wave  field  due  to  ship  forward  speed  when 
evaluating  distance  from  the  waterline  in  calm 
water: 

NoSteady Wave  -  The  steady  wave  due  to  ship 
forward  speed  is  not  included  (default).  This 
option  must  be  used  if  no  steady  wave  data  are 
provided  in  Records  (19)  to  (20d). 

SinkageTrimOnly  -  The  ship  sinkage  and  trim  due 
to  ship  forward  speed  are  included  when  evaluated 
vertical  position  relative  to  the  calm  waterline. 
Sinkage  and  trim  values  specified  in  input  Records 
(19)  to  (19b). 

SteadyWaveElev  -  The  steady  wave  elevation  is 
evaluated  based  on  steady  wave  profile  specified  in 
Records  (20)  to  (20d).  Sinkage  and  trim  from 
Records  (19)  to  (19b)  are  included. 

Record  (21e),  Option  for  Motion-Induced  Interruptions 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 

“miiOption” ,  miiOption  (2  character  strings) 

“miiOption”  Record  tag. 

miiOption  Option  for  motion-induced  interruption  computations: 

Mii  -  Motion-induced  interruption  computations  are  performed. 

NoMii  -  No  motion- induced  interruption  computations  are 
performed. 
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Record  (21el),  Parameters  for  Motion-Induced  Interruptions 

This  record  is  required  if  miiOption  is  set  to  mii  in  Record  (21e). 
“miiParam”,  tipCoLat,  tipCoLong,  durationMii  (1  character  strings,  3  floats) 


“miiParam” 

Record  tag. 

tipCoLat 

Lateral  tipping  coefficient.  A  value  of  0.25  is  typically  used  for 
humans  facing  forward. 

tipCoLong 

Longitudinal  tipping  coefficient.  A  value  of  0.17  is  typically  used 
for  humans  facing  forward. 

durationMii 

Duration  for  computing  incidence  of  motion-induced  interruptions 
(s).  A  value  of  60  s  is  typically  used. 

Note: 

For  sliding  calculations,  the  user  should  set  tipCoLat  and 
tipCoLong  equal  to  the  static  coefficient  of  friction. 

Record  (21f),  Option  for  Slamming,  Deck  Wetness,  or  Emergence  Com¬ 
putations 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 
“slamWetEmergeOption” ,  slamWetEmergeOption  (2  character  strings) 
“slamWetEmergeOption”  Record  tag. 

slamWetEmergeOption  Option  for  slamming,  deck  wetness,  or  emergence 

computations: 

No  Slam  Wet  Emerge  -  No  slamming,  deck  wetness,  or 
emergence  computations  are  performed. 

SlamPressureCoWidth  -  Slamming  calculations  are 
performed  using  an  input  slamming  form  factor  and 
effective  pressure  width  specified  in  Record  (21f2). 

Slam  Wedge  -  Slamming  calculations  are  performed 
using  wedge  dimensions  given  in  Record  (21f3). 

SlamOffsets  -  Slamming  calculations  are  performed 
using  offsets  given  in  Records  (21f4),  (21f5),  and 
(21f6). 

WetnessEmerge  -  Incidence  of  wetness  or  emergence 
calculations  are  performed,  depending  on  whether  the 
position  is  above  or  below  the  waterline. 
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Record  (21fl),  Duration  and  Exceedence  Probability  for  Slamming, 
Wetness,  or  Emergence  Statistics 

This  record  is  required  if  slamWetEmergeOption  in  Record  (21f)  is  set  to 
SlamPressureCoWidth,  Slam  Wedge,  SlamOffsets,  or  WetnessEmerge. 

“durationPExceed” ,  durationHours,  pExceed  (1  character  string,  2  floats) 


“durationPExceed” 

durationHours 

pExceed 


Record  tag. 

Duration  for  slamming,  wetness,  or  emergence  statistics 
(hours) . 

Exceedence  probability  for  slamming,  wetness,  or  emergence 
statistics. 


Record  (21f2),  Slamming  Pressure  Coefficient  and  Effective  Pressure 
Width 

This  record  is  required  if  slamWetEmergeOption  in  Record  (21f)  is  set  to 
SlamPressureCoWidth. 

“slamPressureCoWidth” ,  slamPressureCo,  slamForceWidth  (1  character  string,  2 
floats) 

“slamPressureCoWidth”  Record  tag. 

slamPressureCo  Slamming  pressure  coefficient. 

slamForceWidth  Effective  slamming  force  width  (m). 


Record  (21f3),  Wedge  Geometry  for  Slamming  Calculations 

This  record  is  required  if  slamWetEmergeOption  in  Record  (21f)  is  set  to 
Slam  Wedge. 


“slamWedge” 

“slamWedge” 

deadRiseDeg 


deadRiseDeg,  slamForceHeight  (1  character  string,  2  floats) 

Record  tag. 

Hull  deadrise  angle  at  keel  (degrees).  This  value  must  be 
greater  than  0  degrees.  For  deadrise  angles  less  than  5  degrees, 
this  approach  can  be  inaccurate,  and  is  recommended  that 
either  the  slamForm  or  slamOffsets  option  be  used  instead  for 
slamWetEmergeOption  in  Record  (21f). 


slamForceHeight 


Height  above  the  keel  at  which  slamming  pressure  goes  to  zero 
(typically  taken  as  0.1TX,  where  Tx  is  the  sectional  draft). 
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Record  (21f4),  Elevation  Above  Baseline  for  Zero  Slamming  Pressure 

This  record  is  required  if  slamWetEmergeOption  in  Record  (21f)  is  set  to 
SlamOffsets. 

“zBIZeroSlamPres” ,  zBIZeroSlamPres  (1  character  string,  1  float) 
“zBIZeroSlamPres”  Record  tag. 

zBIZeroSlamPres  Elevation  above  baseline  at  which  slamming  pressure  goes  to 

zero  (m).  This  value  is  typically  assumed  to  be  at  a  height 
of  0.1TX  above  the  baseline,  where  Tx  is  sectional  draft. 

Record  (21f5),  Y  Offsets  for  Performing  Slamming  Calculations 

This  record  is  required  if  slamWetEmergeOption  in  Record  (21f)  is  set  to 
SlamOffsets. 

“yOffsetsSlam” ,  yOffsetsSlam  (1  character  string,  array  of  floats) 

“yOffsetsSlam”  Record  tag. 

yOffsetsSlam  Horizontal  offsets  for  points  going  from  keel  to  at  least 

zBIZeroSlamPres  (Record  (2 lf4) )  above  the  baseline  (m). 

Record  (21f6),  Z  Offsets  for  Performing  Slamming  Calculations 

This  record  is  required  if  slamWetEmergeOption  in  Record  (21f)  is  set  to 
SlamOffsets. 

“zBlOffsetsSlam” ,  zBIOffsetsSlam  (1  character  string,  array  of  floats) 
“zBIOffsetsSlam”  Record  tag. 

zBIOffsetsSlam  Vertical  offsets  for  points  going  from  keel  to  at  least 

zBIZeroSlamPres  (Record  (21f4))  above  the  baseline  (m). 

Record  (21g),  End  of  Seakeeping  Position  Data 

This  record  is  required  if  Record  (21)  is  present. 

“end  seakeepPositions”  (1  character  string  with  2  words) 

Record  (22),  End  Record 

“end  SM3DSeakeepSeaway3”  (1  character  string  with  2  words) 
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E.2  Sample  Input  File  for  SM3DSeakeepSeaway3 

begin  SM3DSeakeepSeaway3 
label  Generic  frigate 

shipDBFileName  genFrigShipForMotionDB.bin 
lengthData  120.000  20.000 

loadCondition  1025.000  4.200  0.000  6.000  0.0000 

enFreqMinMotion  0.1 

speedKnotsRange  10  30  10 

shipHeadingRange  0  345  15 

spectrumOption  DirSpectrura 

begin  dirSpectrum 

dirSpectrumOption  TenParameter 
tenParamParam  30.61  110  140. 41  160  1 
end  dirSpectrum 
waveFreqRange  0.2  2  0.05 
waveDirFromRange  0  360  10 
begin  seakeepPositions 
labelPos  Seakeeping  position 
locationPos  3  2  12 
relMoRadDif Option  NoRadDif 
relWaveElevSteadyOption  NoSteadyWave 
miiOption  Mii 
miiParam  0.25  0.17  60 
motionSicknessOption  MotionSickness 
tDayMotionSickness  0.25 
slamWetEmergeOption  WetnessEmerge 
durationPExceed  1  0.01 
end  seakeepPositions 
end  SM3DSeakeepSeaway3 
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E.3  Sample  Output  File  for  SM3DSeakeepSeaway3 
(Motions  Only  Given  for  One  Ship  Speed, 
Directional  Seaway  Spectral  Densities  Removed) 

Program  SM3DSeakeepSeaway3 

ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Time  :  November-10-11  9:08:02  AM 
Run  label : 

Generic  frigate 

****  ECHO  OF  USER  INPUT  **** 


Input  ship  for  motion  database  file  name: 

genFrigShipForMotionDB . bin 

Label  :  Generic  frigate 

Created  :  November-09- 11  8:19:55  AM 

Version  :  ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Class  :  ShipMo3D . ShipForMotionDB 


Ship  Length  Data 

Length  between  perpendiculars  :  120.000  m 

Station  of  aft  perpendicular  :  20.000 


Ship  Loading  Condition 
Water  density  :  1025.000  kg/m3 
Draft  of  baseline  at  midships 
Trim  of  baseline  by  stern 
Height  of  CG  above  baseline,  KG 
Correction  to  metacentric  height  GM 


4.200  m 
0.000  m 
6.000  m 
0.000  m 


Minimum  wave  encounter  frequency  for  predicting  ship  motions  :  0.100  rad/s 


Speed  range 


Minimum 

10 

000 

knots 

Maximum 

30 

000 

knots 

Increment 

10 

000 

knots 

Sea  direction  range 

Minimum 

0 

000 

deg 

Maximum 

345 

000 

deg 

Increment 

15 

000 

deg 

2 

4.000  m 
0.400  rad/s 


Seaway 

Spectrum  type  : 

Directional  spectrum  type  : 

Ten  parameter  spectrum  parameters 
Wave  system  1 

Significant  wave  height  :  3.000  m 

Peak  wave  frequency  :  0.600  rad/s 
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1.000 

160.000  deg 

1.000 


Spectral  shape  factor 
Mean  wave  direction  (from) 
Directional  spread  exponent 


1.000 

110.000  deg 

1.000 


Incident  wave  frequency  range 


Minimum 

Maximum 

Increment 


0.200  rad/s 
2.000  rad/s 
0.050  rad/s 


for  integration  of  ship  motion  spectra 


Incident  wave  direction  range 
Minimum  :  0.000  deg 

Maximum  :  360.000  deg 

Increment  :  10.000  deg 


(from)  for  integration  of  ship  motion  spectra 


Seakeeping  Positions 

Label  :  Seakeeping  position 

Station  :  3.000 

Lateral  offset  y  :  2.000  m  (+  port) 

Vertical  offset  zBl  :  12.000  m  (+  up,  relative  to  baseline) 

Option  for  including  radiation  and  diffraction  for  relative  motion  :  NoRadDif 

(input) 

Option  for  including  steady  wave  due  to  ship  forward  speed  :  NoSteadyWave  (input) 

Option  for  motion-induced  interruption  computations  :  Mii 

Parameters  for  mot ion- induced  interruptions 

Lateral  tipping  coefficient  :  0.250 

Longitudinal  tipping  coefficient  :  0.170 

Duration  for  Mil  incidence  :  60.0  s 

Option  for  motion  sickness  computations  :  MotionSickness 

Parameters  for  motion  sickness 

Exposure  time  :  0.250  days 

Option  for  slamming,  wetness,  or  emergence  computations  :  WetnessEmerge 
Parameters  for  slamming,  wetness  or  emergence  statistics 
Duration  :  1.000  hours 

Exceedence  probability  :  0.010000 


****  SHIP  LOADING  CONDITION  **** 


Load  Condition  Properties  for  Trimmed  Ship 


Summary  of  hydrostatic  properties 
Number  of  panels  on  port  side 
Total  number  of  panels 
Length  between  perpendiculars 
Draft  of  baseline  at  midships 
Trim  of  baseline  by  stern 
Beam  based  on  maximum  y  value 
Volume 

Water  density 
Mass 

Distance  from  FP  to  X  origin  (m) 


613 

1226 

120.000  m 
4.200  m 
0.000  m 
14.111  m 
3622.358  m3 
1025.000  kg/m3 
3712916.723463  kg 
61.750  m 
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(Origin  located  at  LCG) 

Station  of  X  origin 
Center  of  buoyancy  wrt  waterline 
Wetted  surface  area 
Waterplane  area 

X  value  of  center  of  floatation 
Integral  of  waterplane  area*X**2 
Integral  of  waterplane  area*Y**2 
KG,  height  of  CG  above  baseline 
Height  of  CG  above  waterline 
Metacentric  height  from  hydrostatics 


10.292 
-1.614  m 
1753.438  m2 
1344.310  m2 
-5.022  m 
1234204.219  m4 
17543.814  m4 
6 . 000  m 
1.800  m 
1.430  m 


Inertial  Properties 


Inertia  matrix,  units  of  kg,  kg*m,  and  kg*m2 


3712916.7 

0.0 

0.0 

0.0 

3712916.7 

0.0 

0.0 

0.0 

3712916.7 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

0.0 

Roll  radius  of  gyration  : 

4.800  m 

Pitch  radius 

of  gyration  : 

30.000  m 

Yaw  radius  of 

gyration  : 

30.000  m 

0, 

.0 

0. 

,0 

0, 

,0 

0, 

.0 

0. 

,0 

0. 

,0 

0. 

.0 

0. 

,0 

0. 

,0 

85545601, 

.3 

0. 

,0 

0, 

,0 

0, 

.0 

3341625051. 

,1 

0, 

,0 

0, 

.0 

0. 

,0 

3341625051, 

,1 

Roll  Metacentric  Height  Properities 


)Roll  metacentric  height  from  hull  hydrostatics  : 
Correction  due  to  sloshing  tanks  : 

Input  correction  to  roll  metacentric  height  : 
Corrected  metacentric  height  : 


1.430  m 
0.000  m 
0.000  m 
1.430  m 


Roll  Properties  at  Zero  Forward  Speed 


Roll  added  mass 

Nondimensional  roll  added  mass  A44/I44 
Natural  roll  frequency 
Natural  roll  period 


19548240.530169  kg*m**2 
0.229 

0.704  rad/s 
8.928  s 


****  SHIP  AUTOPILOT  SETTINGS  **** 

Rudder  Autopilots  for  Ship 

Autopilot  for  ship  with  nominally  steady  speed  and  heading 
Key  :  Rudder 
Label  :  Rudder 

Maximum  deflection  :  35.000  deg 

Maximum  velocity  :  3.000  deg/s 
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Maximum  acceleration  :  Not  set  deg/s2 

Response  frequency  :  3.000  rad/s 

Response  damping  :  0.850  rad/s  (fraction  of  critical) 

Maximum  time  step  :  0.100  s 

Autopilot  gains 

Displacement  gains  have  units  of  deg/m  and  deg/deg 
Velocity  gains  have  units  of  deg/ (m/s)  and  deg/ (deg/s) 

Yaw  gains  given  relative  to  earth-fixed  axes  (+yaw  is  clockwise) 


Displacement  gains 
Velocity  gains 


Surge 

0.000 

0.000 


Sway 

0.000 

0.000 


Heave 

0.000 

0.000 


Roll 

0.000 

0.000 


Pitch 

0.000 

0.000 


Yaw 

-4.000 

-8.000 


****  SEAKEEPING  POSITION  TRIM  CONDITIONS  **** 


Seakeeping  position 
3.000 
43.750  m 
2.000  m 
12.000  m 
6.000  m 
7.800  m 

Parameters  for  mot ion- induced  interruptions 
Lateral  tipping  coefficient  :  0.250 

Longitudinal  tipping  coefficient 
Time  of  operation 
Parameters  motion  sickness 
Time  for  motion  sickness 


Label 
Station 
x  wrt  ship  CG 

y 

z  wrt  baseline 
z  wrt  ship  CG 
z  wrt  waterline 


0.170 
60.000  s 


0 . 250  days 


****  DIRECTIONAL  WAVE  SPECTRUM  **** 


Ten  parameter  directional  wave  spectrum 
Significant  wave  height  :  5.000  m 

Wave  system  1 

Significant  wave  height 
Peak  wave  frequency 
Spectral  shape  parameter 
Mean  wave  direction  (from) 

Directional  spreading  exponent 
Significant  wave  height  based  on  directional  wave  spectrum  area 


3. 

,000 

m 

4 

.000 

m 

0. 

,600 

rad/s 

0 

.400 

rad/ s 

1. 

,000 

deg 

1 

.000 

deg 

110. 

,000 

160 

.000 

1. 

,000 

1 

.000 

Wave  frequency 
(rad/s) 

0.200 

0.250 

0.300 

0.350 

0.400 

0.450 

0.500 


Spectral  density 
m2/ (rad/s) 
0.000 
0.036 
1.013 
2.888 
3.641 
3.553 
3.318 


4.984  m 
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0. 

.550 

3, 

.013 

0. 

.600 

2, 

.616 

0. 

.650 

2, 

.177 

0. 

.TOO 

1, 

.760 

0. 

.750 

1, 

.399 

0 

.800 

1, 

.103 

0 

.850 

0, 

.868 

0 

.900 

0, 

.684 

0 

.950 

0, 

.541 

1 

.000 

0, 

.431 

1 

.050 

0, 

.345 

1 

.  100 

0, 

.278 

1 

.  150 

0, 

.226 

1 

.200 

0, 

.185 

1. 

.250 

0, 

.152 

1 

.300 

0, 

.126 

1 

.350 

0, 

.105 

1 

.400 

0, 

.088 

1 

.450 

0, 

.074 

1 

.500 

0, 

.063 

1 

.550 

0, 

.053 

1 

.600 

0, 

.046 

1 

.650 

0, 

.039 

1 

.700 

0, 

.034 

1 

.750 

0, 

.029 

1. 

.800 

0, 

.026 

1 

.850 

0, 

.022 

1 

.900 

0, 

.020 

1 

.950 

0, 

.017 

2 

.000 

0, 

.015 
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y  :  2.000  m 

z  wrt  baseline  :  12.000  m 

z  wrt  ship  CG  :  6.000  m 

z  wrt  waterline  :  7.800  m 

Parameters  for  motion-induced  interruptions 
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Annex  F:  Files  for  Motions  in  an  Earth-Fixed 
Seaway  with 

SM3DSeakeepSeawayFromRaos3 

F.1  Format  of  Input  File  for 

SM3DSeakeepSeaway  From  Raos3 

Record  (1),  Beginning  Record 

“begin  SM3DSeakeepSeawayFromRaos3”  (1  character  string  with  2  words) 

Record  (2),  Run  Label 

“label” ,  label  (2  character  strings) 

“label”  Record  tag. 

label  Label  for  run.  This  can  include  spaces. 

Record  (3),  Beginning  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

“begin  note”  (1  character  string  with  2  words) 

Record  (3a),  Note 

noteText  (character  string) 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

noteText  Text  of  note.  Multiple  lines  can  be  entered. 

Record  (3b),  End  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

“end  note”  (1  character  string  with  2  words) 
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Record  (4),  Ship  Dimensions 

“shipDimensions” ,  lpp,  stationAP,  distanceFPCG,  draftBIMid  trimBIStern, 
shipKG  (1  character  string,  6  floats) 


“shipDimensions” 

lpp 

stationAP 

distanceFPCG 

draftBIMid 

trimBIStern 

shipKG 


Record  tag. 

Ship  length  between  perpendiculars. 

Station  number  for  aft  perpendicular  (typically  20.0). 

Distance  from  fore  perpendicular  to  longitudinal  centre  of 
gravity  (LCG)  (m). 

Draft  of  baseline  at  midships  (m). 

Trim  of  baseline  by  stern  (m). 

ffeight  of  centre  of  gravity  above  baseline  (m). 


Record  (5),  Name  of  File  with  Motion  Response  Amplitude  Operations 

“moDefRaoDBFileName”,  moDefRaoDBFileName  (2  character  strings) 
“moDefRaoDBFileName”  Record  tag. 

moDefRaoDBFileName  Name  of  file  with  ship  motion  and  appendage 

deflection  response  amplitude  operators.  This  file  is 
typically  built  using  application 
SM3DSeakeepRegular3  or  SM3DSeakeepRandom3. 


Record  (6a),  Ship  Speed  Range  in  m/s 

One  of  Records  (6a)  to  (6f)  must  be  given. 

“speedRange” ,  speedMin,  speedMax,  speedlnc  (1  character  string,  3  floats) 

“speedRange”  Record  tag. 

speedMin  Minimum  ship  speed  (m/s). 

speedMax  Maximum  ship  speed  (m/s). 

speedlnc  Increment  for  ship  speed  (m/s). 
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Record  (6b),  Ship  Speeds  in  m/s 

One  of  Records  (6a)  to  (6f)  must  be  given. 

“speeds”,  speeds  (1  character  string,  array  of  floats) 

“speeds”  Record  tag. 

speeds  Array  of  ship  speeds  (m/s). 

Record  (6c),  Ship  Speed  Range  in  Knots 

One  of  Records  (6a)  to  (6f)  must  be  given. 

“speedKnotsRange” ,  speedKnotsMin,  speedKnotsMax,  speedKnotslnc  (1 
character  string,  3  floats) 

“speedKnotsRange”  Record  tag. 

speedKnotsMin  Minimum  ship  speed  (knots). 

speedKnotsMax  Maximum  ship  speed  (knots). 

speedKnotslnc  Increment  for  ship  speed  (knots). 

Record  (6d),  Ship  Speeds  in  Knots 

One  of  Records  (6a)  to  (6f)  must  be  given. 

“speedsKnots” ,  speedsKnots  (1  character  string,  array  of  floats) 

“speedsKnots”  Record  tag. 

speedsKnots  Array  of  ship  speeds  (knots). 

Record  (6e),  Froude  Number  Range 

One  of  Records  (6a)  to  (6f)  must  be  given. 

“FroudeRange” ,  froudeMin,  froudeMax,  froudelnc  (1  character  string,  3  floats) 

“FroudeRange”  Record  tag. 

froudeMin  Minimum  Froude  number. 

froudeMax  Maximum  Froude  number. 

froudelnc  Froude  number  increment. 
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Record  (6f),  Ship  Froude  Numbers 

One  of  Records  (6a)  to  (6f)  must  be  given. 

“Froudes”,  froudes  (1  character  string,  array  of  floats) 

“Froudes”  Record  tag. 

froudes  Array  of  ship  Froude  numbers. 


Record  (Ta),  Range  of  Ship  Headings 

One  of  Records  (7a)  or  (7b)  must  be  given. 

“shipHeadingRange” ,  shipHeadingDegMin,  shipHeadingDegMax, 
shipHeadingDeglnc  (1  character  string,  3  floats) 


“shipHeadingRange” 

shipHeadingDegMin 

shipHeadingDegMax 

shipHeadingDeglnc 

Note: 


Record  tag. 

Minimum  ship  heading  (to,  deg). 

Maximum  ship  heading  (to,  deg). 

Increment  for  ship  heading  (to,  deg). 

The  ship  heading  convention  is  0°  for  the  ship  heading 
north,  90°  for  the  ship  heading  east. 


Record  (7b),  Ship  Headings 

One  of  Records  (7a)  or  (7b)  must  be  given. 

“shipHeadingsDeg” ,  shipHeadingsDeg  (1  character  string,  array  of  floats) 
“shipHeadingsDeg”  Record  tag. 

shipHeadingsDeg  Array  of  ship  headings  (deg).  The  ship  heading  convention 

is  0°  for  the  ship  heading  north,  90°  for  the  ship  heading 
east. 
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Record  (8),  Seaway  Option 

“spectrumOption” ,  spectrumOption  (2  character  strings) 

“spectrumOption”  Record  tag. 

spectrumOption  Type  of  seaway. 

UniSpectrum  -  Unidirectional  seaway  based  on  input 
spectrum. 

CosSpectrum  -  Directional  spectrum  describe  by  a  point 
wave  spectrum  and  cosine-squared  spreading  function. 

DirSpectrum  -  Directional  seaway  with  specified  directional 
properties. 

Record  (9),  Beginning  of  Unidirectional  Wave  Spectrum 

Records  (9)  to  (9d)  are  required  if  spectrumOption  is  set  to  UniSpectrum  in 
Record  (8). 

“begin  UniSpectrum”  (1  character  string  with  2  words) 

Record  (9a),  Wave  Heading 

This  record  is  required  if  seawayOption  in  Record  (8)  is  set  to  UniSpectrum. 
“waveHeading” ,  waveHeadingFromDeg  (1  character  string,  1  float) 
“waveHeading”  Record  tag. 

waveHeadingFromDeg  Wave  direction  v  (from,  degrees).  0°  for  waves  from 

north,  and  90°  for  waves  from  east. 
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Record  (9b),  Unidirectional  Wave  Spectrum  Option 

This  record  is  required  if  spectrumOption  in  Record  (8)  is  set  to  UniSpectrum. 
“uniSpectrumOption” ,  uniSpectrumOption  (2  character  strings) 
“uniSpectrumOption”  Record  tag. 

uniSpectrumOption  Type  of  unidirectional  wave  spectrum. 

Bretschneider  -  Unidirectional  Bretschneider  wave 
spectrum. 

JONSWAP  -  Unidirectional  JONSWAP  wave  spectrum. 

OchiHubble  -  Unidirectional  Ochi  and  Hubble  six 
parameter  wave  spectrum. 

Input  -  Unidirectional  user-input  wave  spectrum. 

Record  (9cl),  Unidirectional  Bretschneider  Spectrum  Seaway  Parame¬ 
ters 

This  record  is  required  if  uniSpectrumOption  in  Record  (9b)  is  set  to 
Bretschneider. 

“BretParam”,  hs,  tp  (1  character  string,  2  floats) 

“BretParam”  Record  tag. 
hs  Significant  wave  height  Hs  (m). 

tp  Peak  wave  period  Tp  (s). 

Record  (9c2),  Unidirectional  JONSWAP  Spectrum  Seaway  Parameters 

This  record  is  required  if  uniSpectrumOption  in  Record  (9b)  is  set  to  JONSWAP. 
“JONSWAPParam”,  hs,  tp,  peakEnhance  (1  character  string,  3  floats) 

“JON  SWAP  Par  am”  Record  tag. 
hs  Significant  wave  height  Hs  (m). 

tp  Peak  wave  period  Tp  (s). 

peakEnhance  Peak  enhancement  factor  7.  This  factor  can  be  set  to  3.3 

to  match  a  2  parameter  JONSWAP  spectrum. 
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Record  (9c3),  Unidirectional  Ochi  Hubble  Spectrum  Parameters 

This  record  is  required  if  uniSpectrumOption  in  Record  (9b)  is  set  to 
OchiHubble. 

“OchiHubbleParam”,  hsl,  freqPeakl,  spectralShapel,  hs2,  freqPeak2, 
spectralShape2  (1  character  string,  6  floats) 

“OchiHubbleParam”  Record  tag. 


hsl 

freqPeakl 

spectralShapel 

hs2 

freqPeak2 

spectralShape2 


Significant  wave  height  hs_ i  of  wave  system  1  (m). 
Peak  wave  frequency  ujp-i  of  wave  system  1  (rad/s). 
Spectral  shape  factor  Ai  of  wave  system  1. 
Significant  wave  height  hs_ 2  of  wave  system  2  (m). 
Peak  wave  frequency  cup_2  of  wave  system  2  (rad/s). 
Spectral  shape  factor  A2  of  wave  system  2. 


Record  (9c4),  Unidirectional  Input  Spectrum  Wave  Frequencies 

This  record  is  required  if  uniSpectrumOption  in  Record  (9b)  is  set  to  Input, 
“input WaveFreqs” ,  input WaveFreqs  (1  character  string,  array  of  floats) 

“input WaveFreqs”  Record  tag. 

input  WaveFreqs  Wave  frequencies  u>i  for  input  energy  densities  (rad/s). 

Record  (9c5),  Unidirectional  Input  Spectrum  Energy  Densities 

This  record  is  required  if  uniSpectrumOption  in  Record  (9b)  is  set  to  Input 
“inputEnergyDensities” ,  inputEnergyDensities  (1  character  string,  array  of  floats) 
“inputEnergyDensities”  Record  tag. 

inputEnergyDensities  Wave  spectrum  energy  densities  SUl(coj)  corresponding 

to  wave  frequencies  of  Record  (9c4). 

Record  (9d),  End  of  Unidirectional  Wave  Spectrum 

This  record  is  required  if  spectrumOption  is  set  to  UniSpectrum  in  Record  (8). 
“end  uniSpectrum”  (1  character  string  with  2  words) 
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Record  (10),  Beginning  of  Cosine-squared  Spreading  Wave  Spectrum 

Records  (10)  to  (lOd)  are  required  if  spectrumOption  is  set  to  CosSpectrum  in 
Record  (8). 

“begin  cosSpectrum”  (1  character  string  with  2  words) 

Record  (10a),  Mean  Wave  Heading 

This  record  is  required  if  seawayOption  in  Record  (8)  is  set  to  CosSpectrum. 
“waveHeadingMean” ,  waveHeadingMeanDeg  (1  character  string,  1  float) 
“waveHeadingMean”  Record  tag. 

waveHeadingMeanDeg  Mean  wave  direction  v  (from,  degrees).  0°  for  waves 

from  north,  and  90°  for  waves  from  east. 

Record  (10b),  Wave  Spreading  Angle 

This  record  is  required  if  spectrumOption  in  Record  (8)  is  set  to  CosSpectrum. 
“spreadAngle” ,  spreadAngleDeg  (1  character  string,  1  float) 

“spreadAngle”  Record  tag. 

spreadAngleDeg  Directional  spreading  angle  (deg). 

Record  (10c),  Cosine-Squared  Wave  Spectrum  Option 

This  record  is  required  if  spectrumOption  in  Record  (8)  is  set  to  CosSpectrum. 
“cosSpectrumOption” ,  cosSpectrumOption  (2  character  strings) 
“cosSpectrumOption”  Record  tag. 

cosSpectrumOption  Type  of  wave  spectrum  with  cosine-squared  directional 

spreading: 

CosBretschneider  -  Bretschneider  wave  spectrum  with 
cosine-squared  directional  spreading. 

Cos  JONS  WAP  -  JONSWAP  wave  spectrum  with 
cosine-squared  directional  spreading. 
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Record  (lOcl),  Cosine-squared  Bretschneider  Spectrum  Parameters 

This  record  is  required  if  cosSpectrumOption  in  Record  (10c)  is  set  to 
CosBretschneider . 

“BretParam”,  hs,  tp  (1  character  string,  2  floats) 

“BretParam”  Record  tag. 
hs  Significant  wave  height  Hs  (m). 

tp  Peak  wave  period  Tp  (s). 

Record  (10c2),  Cosine-squared  JONSWAP  Spectrum  Seaway  Parame¬ 
ters 

This  record  is  required  if  cosSpectrumOption  in  Record  (10c)  is  set  to 
CosJONSWAP. 

“JONSWAPParam”,  hs,  tp,  peakEnhance  (1  character  string,  3  floats) 
“JONSWAPParam”  Record  tag. 
hs  Significant  wave  height  Hs  (nr), 

tp  Peak  wave  period  Tp  (s). 

peakEnhance  Peak  enhancement  parameter  7.  This  factor  can  be  set  to 

3.3  to  match  a  2  parameter  JONSWAP  spectrum. 

Record  (lOd),  End  of  Cosine-squared  Spreading  Wave  Spectrum 

This  record  is  required  if  spectrumOption  is  set  to  CosSpectrum  in  Record  (8). 
“end  cosSpectrum”  (1  character  string  with  2  words) 

Record  (11),  Beginning  of  Directional  Wave  Spectrum 

Records  (11)  to  (lid)  are  required  if  spectrumOption  is  set  to  DirSpectrum  in 
Record  (8). 

“begin  dirSpectrum”  (1  character  string  with  2  words) 
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Record  (11a),  Directional  Wave  Spectrum  Option 

This  record  is  required  if  spectrumOption  in  Record  (8)  is  set  to  DirSpectrum. 
“dirSpectrumOption” ,  dirSpectrumOption  (2  character  strings) 
“dirSpectrumOption”  Record  tag. 


dirSpectrumOption 

Type  of  unidirectional  wave  spectrum: 

TenParameter  -  Ten  parameter  spectrum  from  Hogben 
and  Cobb  [23]. 

EndecoWaveBuoy  -  Directional  spectrum  from  Endeco 
wave  buoy. 

InputDir  -  Input  directional  spectrum. 

Record  (llal),  Ten  Parameter  Spectrum  Parameters 

This  record  is  required  if  dirSpectrumOption  in  Record  (11a)  is  set  to 
TenParameter. 

“tenParamParam” ,  hsl,  freqPeakl,  spectralShapel,  waveHeadingMeanDegl, 
dirSpreadExpl,  hs2,  freqPeak2,  spectralShape2,  waveHeadingMeanDeg2, 
dirSpreadExp2  (1  character  string,  10  floats) 

“tenParamParam”  Record  tag. 


hsl 

Significant  wave  height  hs-\  of  wave  system  1  (m). 

freqPeakl 

Peak  wave  frequency  cup_i  of  wave  system  1  (rad/s). 

spectralShapel 

Spectral  shape  factor  Ai  of  wave  system  1. 

waveHeadingMeanDegl  Principle  wave  direction  zq  (from,  degrees)  of  wave 


dirSpreadExpl 

system  1.  0°  for  waves  from  north,  and  90°  for  waves 
from  east. 

Directional  spreading  exponent  P\  of  wave  system  1. 

hs2 

Significant  wave  height  hs_ 2  of  wave  system  2  (m). 

freqPeak2 

Peak  wave  frequency  cup_2  of  wave  system  2  (rad/s). 

spectralShape2 

Spectral  shape  factor  A2  of  wave  system  2. 

waveHeadingMeanDeg2  Principle  wave  direction  z/2  (from,  degrees)  of  wave 


dirSpreadExp2 

system  2.  0°  for  waves  from  north,  and  90°  for  waves 
from  east. 

Directional  spreading  exponent  P2  of  wave  system  2. 
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Record  (lib),  Endeco  Wave  Buoy  Spectrum  File  Name 

This  record  is  required  if  spectrumOption  in  Record  (8)  is  set  to 
EndecoWaveBuoy. 

“EndecoSpectrumFileName”,  EndecoSpectrumFileName  (2  character  strings) 
“EndecoSpectrumFileName”  Record  tag. 

EndecoSpectrumFileName  File  name  of  directional  wave  spectrum  file 

produced  by  Endeco  956  or  1156  wave  buoy.  The 
file  name  will  typically  have  the  extension  “.std”. 

Record  (11c),  Input  Directional  Wave  Spectrum  File  Name 

This  record  is  required  if  spectrumOption  in  Record  (8)  is  set  to  inputDir. 
“inputDirSpectrumFileName”,  inputDirSpectrumFileName  (2  character  strings) 
“inputDirSpectrumFileName”  Record  tag. 

inputDirSpectrumFileName  Input  directional  wave  spectrum  file  name.  The 

format  of  the  directional  wave  spectrum  file  is 
given  in  Annex  A. 2. 

Record  (lid),  End  of  Directional  Wave  Spectrum 

This  record  is  required  if  spectrumOption  is  set  to  DirSpectrum  in  Record  (8). 
“end  dir  Spectrum”  (1  character  string  with  2  words) 

Record  (12a),  Range  of  Incident  Wave  Frequencies  for  Integration  of 
Ship  Motion  Spectrum 

One  of  Records  (12a)  or  (12b)  must  be  given. 

“waveFreqRange”,  waveFreqMin,  waveFreqMax,  waveFreqlnc  (1  character  string, 
3  floats) 

“waveFreqRange”  Record  tag. 

waveFreqMin  Minimum  incident  wave  frequency  (rad/s). 

waveFreqMax  Maximum  incident  wave  frequency  (rad/s). 

waveFreqlnc  Increment  for  incident  wave  frequency  (rad/s). 
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Record  (12b),  Incident  Wave  Frequencies  for  Integration  of  Ship  Motion 
Spectrum 

One  of  Records  (12a)  or  (12b)  must  be  given. 

“waveFreqs”,  waveFreqs  (1  character  string,  array  of  floats) 

“waveFreqs”  Record  tag. 

waveFreqs  Array  of  increasing  incident  wave  frequencies  (rad/s). 


Record  (13a),  Wave  Direction  Range  for  Integration  of  Ship  Motion 
Spectrum 

If  spectrumOption  in  Record  (8)  is  set  to  CosSpectrum  or  DirSpectrum,  then  one 
of  Records  (13a)  or  (13b)  must  be  given. 

“waveDirFromRange” ,  waveDirFromDegMin,  waveDirFromDegMax, 
waveDirFromDeglnc  (1  character  string,  3  floats) 


“waveDirFromRange” 

waveDirFromDegMin 


Record  tag. 

Minimum  wave  direction  (deg). 


waveDirFromDegMax  Maximum  wave  direction  (deg). 


waveDirFromDeglnc 

Note: 


Wave  direction  increment  (deg). 

Wave  directions  are  given  using  a  convention  of  0°  for 
waves  from  north,  90°  for  waves  from  east. 


Record  (13b),  Wave  Directions  Integration  of  Ship  Motion  Spectrum 

If  spectrumOption  in  Record  (8)  is  set  to  CosSpectrum  or  DirSpectrum,  then  one 
of  Records  (13a)  or  (13b)  must  be  given. 

“waveDirsFrom” ,  waveDirsFromDeg  (1  character  string,  array  of  floats) 
“waveDirsFrom”  Record  tag. 

waveDirsFromDeg  Wave  directions  for  integration  of  ship  motion  spectrum. 

Wave  directions  are  given  using  a  convention  of  0°  for  waves 
from  north,  90°  for  waves  from  east. 


Record  (14),  Beginning  of  Steady  Forward  Speed  Sinkage  and  Trim 
Data 

Records  (14)  to  (14b)  can  optionally  be  used  to  give  ship  sinkage  and  trim  data, 
“begin  steadySinkageTrim”  (1  character  string  with  2  words) 
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Record  (14a),  Sinkage  and  Trim  for  Ship  Speed 

This  record  is  repeated  once  for  every  ship  speed  with  sinkage  and  trim  data, 
with  increasing  ship  speeds. 

“speedSinkageTrim” ,  speedSinkageTrim,  heaveSteady,  pitchSteadyDeg  (1 
character  string,  3  floats) 

“speedSinkageTrim”  Record  tag. 

speedSinkageTrim  Speed  for  which  sinkage  and  trim  values  are  given  (m/s) 
heaveSteady  Heave  at  steady  speed  (m,  +  up). 

pitchSteadyDeg  Pitch  at  steady  speed  (deg,  +  bow  down). 

Record  (14b),  End  of  Steady  Sinkage  and  Trim  Data 

This  record  is  required  if  Records  (14)  and  (14a)  are  included. 

“end  steadySinkageTrim”  (1  character  string  with  2  words) 

Record  (15),  Beginning  of  Steady  Forward  Speed  Wave  Elevation  Data 

Records  (15)  to  (15d)  can  optionally  be  used  to  give  ship  steady  wave  profile  data 
data. 

“begin  steady WaveProfile”  (1  character  string  with  2  words) 

Record  (15a),  Stations  for  Steady  Wave  Elevation  Data 

This  record  is  required  if  steady  wave  elevation  data  are  being  given. 

“stationsSteadyWaveProfile” ,  stationsSteadyWaveProfile  (1  character  string, 
nStationSteady WaveProfile  floats) 

“stationsSteadyWaveProfile”  Record  tag. 

stationsSteadyWaveProfile  Ship  stations  for  steady  wave  elevation  data. 

Record  (15b),  Speeds  in  m/s  for  Steady  Wave  Elevation  Data 

This  record  is  required  if  steady  wave  elevation  data  are  being  given. 

“speedsSteady WaveProfile” ,  speedsSteadyWaveProfile  (1  character  string, 
nSpeedSteadyWaveProfile  floats) 

“speedsSteadyWaveProfile”  Record  tag. 

speedsSteadyWaveProfile  Ship  speeds  for  steady  wave  elevation  data  (m/s). 
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Record  (15c),  Steady  Wave  Elevation  Profile  Data 

This  record  must  be  given  for  each  station  with  steady  wave  elevation  data. 

“stationSteadyWaveElevs” ,  stationSteadyWave,  waveElevsSteady  (1  character 
string,  1  +  nSpeedSteadyWaveProfile  floats) 

“stationSteadyWaveElevs”  Record  tag. 

stationSteadyWave  Station  number  for  input  wave  elevations.  This 

value  must  be  consistent  with  values  given  in  Record 
(15a). 

waveElevsSteady  Wave  elevations  (m)  at  stationSteadyWave  for  ship 

speeds  specified  in  Record  (15b). 

Record  (15d),  End  of  Steady  Wave  Profile  Data 

This  record  is  required  if  Record  (15)  and  subsequent  records  have  been  entered, 
“end  steady WaveProfile”  (1  character  string  with  2  words) 

Record  (16),  Beginning  of  Seakeeping  Position  Data 

This  record  is  optional. 

“begin  seakeepPositions”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (16a)  to  (16f6)  giving  seakeeping  position 
parameters.  Record  (16g)  must  follow  at  the  end  of  all  seakeeping 
position  data. 

Record  (16a),  Seakeeping  Position  Label 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 

“labelPos”,  labelPos  (2  character  strings) 

“labelPos”  Record  tag. 

labelPos  Label  for  seakeeping  position.  This  can  include  spaces. 
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Record  (16b),  Seakeeping  Position  Location 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 

“locationPos” ,  stationPos,  yPos,  zBIPos  (1  character  string,  3  floats) 
“locationPos”  Record  tag. 

stationPos  Station  for  seakeeping  position.  Station  0  is  at  the  fore 
perpendicular. 

yPos  Lateral  coordinate  (+  port)  relative  to  ship  centreline  (nr). 

zBIPos  Vertical  coordinate  (+  up)  relative  to  ship  baseline  (nr). 

Record  (16c),  Option  for  Radiation  and  Diffraction  when  Evaluating 
Relative  Vertical  Motion 

This  record  is  optional  if  a  seakeeping  position  is  being  specified. 
“relMoRadDifOption”  relMoRadDifOption  (2  character  strings) 
“relMoRadDifOption”  Record  tag. 

relMoRadDifOption  Option  for  including  radiation  and  diffraction  in  relative 

vertical  motion: 

NoRadDif  -  Wave  radiation  and  diffraction  are  not 
considered  when  evaluating  relative  wave  motion 
(default). 
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Record  (16d),  Option  for  Including  the  Steady  Wave  Due  to  Ship  For¬ 
ward  Speed  when  Evaluating  Wetness  or  Emergence  Events 

This  record  is  optional  if  a  seakeeping  position  is  being  specified. 

“relWaveElevSteadyOption” ,  relWaveElevSteadyOption  (2  character  strings) 

“relWaveElevSteadyOptioiE  Record  tag. 

relWaveElevSteadyOption  Option  for  including  the  influence  of  the  steady 

wave  field  due  to  ship  forward  speed  when 
evaluating  distance  from  the  waterline  in  calm 
water: 

NoSteady Wave  -  The  steady  wave  due  to  ship 
forward  speed  is  not  included  (default).  This 
option  must  be  used  if  no  steady  wave  data  are 
provided  in  Records  (14)  to  (15d). 

SinkageTrimOnly  -  The  ship  sinkage  and  trim  due 
to  ship  forward  speed  are  included  when  evaluated 
vertical  position  relative  to  the  calm  waterline. 
Sinkage  and  trim  values  specified  in  input  Records 
(14)  to  (14b). 

SteadyWaveElev  -  The  steady  wave  elevation  is 
evaluated  based  on  steady  wave  profile  specified  in 
Records  (15)  to  (15d).  Sinkage  and  trim  from 
Records  (14)  to  (14b)  are  included. 

Record  (16e),  Option  for  Motion-Induced  Interruptions 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 

“miiOption” ,  miiOption  (2  character  strings) 

“miiOption”  Record  tag. 

miiOption  Option  for  motion-induced  interruption  computations: 

Mii  -  Motion-induced  interruption  computations  are  performed. 

NoMii  -  No  motion- induced  interruption  computations  are 
performed. 
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Record  (16el),  Parameters  for  Motion-Induced  Interruptions 

This  record  is  required  if  miiOption  is  set  to  mii  in  Record  (16e). 
“miiParam”,  tipCoLat,  tipCoLong,  durationMii  (1  character  strings,  3  floats) 


“miiParam” 

Record  tag. 

tipCoLat 

Lateral  tipping  coefficient.  A  value  of  0.25  is  typically  used  for 
humans  facing  forward. 

tipCoLong 

Longitudinal  tipping  coefficient.  A  value  of  0.17  is  typically  used 
for  humans  facing  forward. 

durationMii 

Duration  for  computing  incidence  of  motion-induced  interruptions 
(s).  A  value  of  60  s  is  typically  used. 

Note: 

For  sliding  calculations,  the  user  should  set  tipCoLat  and 
tipCoLong  equal  to  the  static  coefficient  of  friction. 

Record  (16f),  Option  for  Slamming,  Deck  Wetness,  or  Emergence  Com¬ 
putations 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 
“slamWetEmergeOption” ,  slamWetEmergeOption  (2  character  strings) 
“slamWetEmergeOption”  Record  tag. 

slamWetEmergeOption  Option  for  slamming,  deck  wetness,  or  emergence 

computations: 

No  Slam  Wet  Emerge  -  No  slamming,  deck  wetness,  or 
emergence  computations  are  performed. 

SlamPressureCoWidth  -  Slamming  calculations  are 
performed  using  an  input  slamming  form  factor  and 
effective  pressure  width  specified  in  Record  (16f2). 

Slam  Wedge  -  Slamming  calculations  are  performed 
using  wedge  dimensions  given  in  Record  (16f3). 

SlamOffsets  -  Slamming  calculations  are  performed 
using  offsets  given  in  Records  (16f4),  (16f5),  and 
(16f6). 

WetnessEmerge  -  Incidence  of  wetness  or  emergence 
calculations  are  performed,  depending  on  whether  the 
position  is  above  or  below  the  waterline. 
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Record  (16fl),  Duration  and  Exceedence  Probability  for  Slamming, 
Wetness,  or  Emergence  Statistics 

This  record  is  required  if  slamWetEmergeOption  in  Record  (16f)  is  set  to 
SlamPressureCoWidth,  Slam  Wedge,  SlamOffsets,  or  WetnessEmerge. 

“durationPExceed” ,  durationHours,  pExceed  (1  character  string,  2  floats) 


“durationPExceed” 

durationHours 

pExceed 


Record  tag. 

Duration  for  slamming,  wetness,  or  emergence  statistics 
(hours) . 

Exceedence  probability  for  slamming,  wetness,  or  emergence 
statistics. 


Record  (16f2),  Slamming  Pressure  Coefficient  and  Effective  Pressure 
Width 

This  record  is  required  if  slamWetEmergeOption  in  Record  (16f)  is  set  to 
SlamPressureCoWidth. 

“slamPressureCoWidth” ,  slamPressureCo,  slamForceWidth  (1  character  string,  2 
floats) 

“slamPressureCoWidth”  Record  tag. 

slamPressureCo  Slamming  pressure  coefficient. 

slamForceWidth  Effective  slamming  force  width  (m). 


Record  (16f3),  Wedge  Geometry  for  Slamming  Calculations 

This  record  is  required  if  slamWetEmergeOption  in  Record  (16f)  is  set  to 
Slam  Wedge. 


“slamWedge” 

“slamWedge” 

deadRiseDeg 


deadRiseDeg,  slamForceHeight  (1  character  string,  2  floats) 

Record  tag. 

Hull  deadrise  angle  at  keel  (degrees).  This  value  must  be 
greater  than  0  degrees.  For  deadrise  angles  less  than  5  degrees, 
this  approach  can  be  inaccurate,  and  is  recommended  that 
either  the  slamForm  or  slamOffsets  option  be  used  instead  for 
slamWetEmergeOption  in  Record  (16f). 


slamForceHeight 


Height  above  the  keel  at  which  slamming  pressure  goes  to  zero 
(typically  taken  as  0.1TX,  where  Tx  is  the  sectional  draft). 
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Record  (16f4),  Elevation  Above  Baseline  for  Zero  Slamming  Pressure 

This  record  is  required  if  slamWetEmergeOption  in  Record  (16f)  is  set  to 
SlamOffsets. 

“zBIZeroSlamPres” ,  zBIZeroSlamPres  (1  character  string,  1  float) 
“zBIZeroSlamPres”  Record  tag. 

zBIZeroSlamPres  Elevation  above  baseline  at  which  slamming  pressure  goes  to 

zero  (m).  This  value  is  typically  assumed  to  be  at  a  height 
of  0.1TX  above  the  baseline,  where  Tx  is  sectional  draft. 

Record  (16f5),  Y  Offsets  for  Performing  Slamming  Calculations 

This  record  is  required  if  slamWetEmergeOption  in  Record  (16f)  is  set  to 
SlamOffsets. 

“yOffsetsSlam” ,  yOffsetsSlam  (1  character  string,  array  of  floats) 

“yOffsetsSlam”  Record  tag. 

yOffsetsSlam  Horizontal  offsets  for  points  going  from  keel  to  at  least 

zBIZeroSlamPres  (Record  (16f4))  above  the  baseline  (m). 

Record  (16f6),  Z  Offsets  for  Performing  Slamming  Calculations 

This  record  is  required  if  slamWetEmergeOption  in  Record  (16f)  is  set  to 
SlamOffsets. 

“zBlOffsetsSlam” ,  zBIOffsetsSlam  (1  character  string,  array  of  floats) 
“zBIOffsetsSlam”  Record  tag. 

zBIOffsetsSlam  Vertical  offsets  for  points  going  from  keel  to  at  least 

zBIZeroSlamPres  (Record  (16f4))  above  the  baseline  (m). 

Record  (16g),  End  of  Seakeeping  Position  Data 

This  record  is  required  if  Record  (16)  is  present. 

“end  seakeepPositions”  (1  character  string  with  2  words) 

Record  (IT),  End  Record 

“end  SM3DSeakeepSeawayFromRaos3”  (1  character  string  with  2  words) 
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F.2  Sample  Input  File  for 

SM3DSeakeepSeaway  From  Raos3 

begin  SM3DSeakeepSeawayFromRaos3 
label  Generic  frigate 

shipDiraensions  120  20  61.7501556572279  4.2  0  6 

raoDefRaoDBFileName  genFrigSeakeepRandomMoDefRaoDB.bin 

speedKnotsRange  0  30  10 

shipHeadingRange  0  345  15 

spectrumOption  DirSpectrum 

begin  dirSpectrum 

dirSpectruraOption  TenParameter 
tenParamParam  30.61  110  140. 41  160  1 
end  dirSpectrum 
waveFreqRange  0.2  2  0.05 
waveDirFromRange  0  360  5 
begin  seakeepPositions 
labelPos  Bridge 

locationPos  3  2  12 
relMoRadDif Option  NoRadDif 
relWaveElevSteadyOption  NoSteadyWave 
miiOption  Mii 
miiParam  0.25  0.17  60 
motionSicknessOption  MotionSickness 
tDayMotionSickness  0.25 
slamWetEmergeOption  WetnessEmerge 
durationPExceed  1  0.01 
end  seakeepPositions 
end  SM3DSeakeepSeawayFromRaos3 


266 


DRDC  Atlantic  TM  2011-308 


F.3  Sample  Output  File  for 

SM3DSeakeepSeaway  From  Raos3 

Program  SM3DSeakeepSeawayFromRaos3 
ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Time  :  November-10-11  1:58:37  PM 
Run  label: 

Generic  frigate 

****  ECHO  OF  USER  INPUT  **** 

Ship  Dimensions 
Length  between  perpendiculars 
Station  number  of  aft  perpendicular 
Distance  from  fore  perpendicular  to  LCG 
Draft  of  baseline  at  midships 
Trim  of  baseline  by  stern 
Height  of  CG  above  baseline 

File  name  with  ship  motion  RAOs  : 
genFrigSeakeepRandomMoDef RaoDB .bin 
Label  :  Generic  frigate 
Created  :  November- 10- 11  9:07:44  AM 
Version  :  ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Class  :  ShipMo3D.FreqDomain.MotionDeflectRaoDB 


120.000  m 
20.000 
61.750 
4.200  m 
0.000  m 
6.000  m 


Speed  range 
Minimum  : 
Maximum  : 
Increment  : 


0.000  knots 
30.000  knots 
10.000  knots 


Sea  direction 

range 

Minimum  : 

0 

000 

deg 

Maximum  : 

345 

000 

deg 

Increment  : 

15 

000 

deg 

Seaway 

Spectrum  type  : 

Directional  spectrum  type  : 

Ten  parameter  spectrum  parameters 
Wave  system  1 

Significant  wave  height  :  3.000  m 

Peak  wave  frequency  :  0.600  rad/s 

Spectral  shape  factor  :  1.000 

Mean  wave  direction  (from)  :  110.000  deg 

Directional  spread  exponent  :  1.000 


2 

4.000  m 
0.400  rad/s 
1.000 

160.000  deg 
1.000 


Incident  wave  frequency  range  for  integration  of  ship  motion  spectra 
Minimum  :  0.200  rad/s 

Maximum  :  2 . 000  rad/s 
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Increment  : 


0 . 050  rad/ s 


Incident  wave 
Minimum  : 
Maximum  : 
Increment  : 


direction  range  (from)  for  integration  of  ship  motion  spectra 
0.000  deg 
360.000  deg 
5.000  deg 


Seakeeping  Positions 


Label  :  Bridge 

Station  :  3.000 

Lateral  offset  y  :  2.000  m  (+  port) 

Vertical  offset  zBl  :  12.000  m  (+  up,  relative  to  baseline) 

Option  for  including  radiation  and  diffraction  for  relative  motion  :  NoRadDif 

(input) 

Option  for  including  steady  wave  due  to  ship  forward  speed  :  NoSteadyWave  (input) 

Option  for  motion-induced  interruption  computations  :  Mii 

Parameters  for  mot ion- induced  interruptions 

Lateral  tipping  coefficient  :  0.250 

Longitudinal  tipping  coefficient  :  0.170 

Duration  for  Mil  incidence  :  60.0  s 

Option  for  motion  sickness  computations  :  MotionSickness 

Parameters  for  motion  sickness 

Exposure  time  :  0.250  days 

Option  for  slamming,  wetness,  or  emergence  computations  :  WetnessEmerge 
Parameters  for  slamming,  wetness  or  emergence  statistics 
Duration  :  1.000  hours 

Exceedence  probability  :  0.010000 


****  SEAKEEPING  POSITION  TRIM  CONDITIONS  **** 


Label 
Station 
x  wrt  ship  CG 


Bridge 

3.000 
43.750  m 


z  wrt  baseline 
z  wrt  ship  CG 
z  wrt  waterline 


2.000  m 
12.000  m 
6.000  m 
7.800  m 


Parameters  for  mot ion- induced  interruptions 


Lateral  tipping  coefficient 
Longitudinal  tipping  coefficient 
Time  of  operation 
Parameters  motion  sickness 
Time  for  motion  sickness 


0.250 

0.170 

60.000 


s 

0.250  days 


****  DIRECTIONAL  WAVE  SPECTRUM  **** 

Ten  parameter  directional  wave  spectrum 

Significant  wave  height  :  5.000  m 

Wave  system  1  2 
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Significant  wave  height 
Peak  wave  frequency 
Spectral  shape  parameter 
Mean  wave  direction  (from) 
Directional  spreading  exponent 


3.000  m 
0.600  rad/s 
1 . 000  deg 
110.000 
1.000 


Significant  wave  height  based  on  directional  wave 


4.000  m 
0 . 400  rad/ s 
1.000  deg 
160.000 
1.000 

spectrum  area  : 


4.989  m 


Wave  frequency 
(rad/s) 

0.200 

0.250 

0.300 

0.350 

0.400 

0.450 

0.500 

0.550 

0.600 

0.650 

0.700 

0.750 

0.800 

0.850 

0.900 

0.950 

1.000 

1.050 

1.100 

1.150 

1.200 

1.250 

1.300 

1.350 

1.400 

1.450 

1.500 

1.550 

1.600 

1.650 

1.700 

1.750 

1.800 

1.850 

1.900 

1.950 

2.000 


Spectral  density 
m2/ (rad/s) 
0.000 
0.036 
1.013 
2.889 
3.643 
3.556 
3.323 
3.020 
2.622 
2.184 
1.766 
1.404 
1.107 
0.871 
0.686 
0.543 
0.432 
0.346 
0.279 
0.227 
0.185 
0.153 
0.126 
0.105 
0.088 
0.074 
0.063 
0.054 
0.046 
0.039 
0.034 
0.029 
0.026 
0.022 
0.020 
0.017 
0.015 
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Ship  speed  :  10.300  m/s  (20.000  knots,  Froude  number  0.300) 

Ship  heading  (to)  is  in  earth-fixed  axes. 

0  degrees  for  ship  heading  north,  90  degrees  for  ship  heading  east 
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Seakeeping  at  Position  on  Ship 
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285.0  0.079  10.1  22.4  0.52  20.9 
300.0  0.074  10.6  19.1  0.54  17.5 
315.0  0.073  10.7  18.3  0.55  16.7 
330.0  0.076  10.5  20.3  0.54  18.7 
345.0  0.084  10.0  24.5  0.51  23.1 
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300.0  0.795  7.0  0.711  0.000000  0.000 
315.0  0.781  7.0  0.702  0.000000  0.000 
330.0  0.792  6.6  0.750  0.000000  0.000 
345.0  0.829  6.2  0.843  0.000000  0.000 
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Annex  G:  Files  for  Producing  Time  Series  of 
Ship  Motions  based  on  Response 
Amplitude  Operators 

G.1  Format  of  Input  File  for 

SM3DTimeSeriesFromRaos3 

Record  (1),  Beginning  Record 

“begin  SM3DTimeSeriesFromRaos3”  (1  character  string  with  2  words) 

Record  (2),  Run  Label 

“label” ,  label  (2  character  strings) 

“label”  Record  tag. 

label  Label  for  run.  This  can  include  spaces. 

Record  (3),  Beginning  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

“begin  note”  (1  character  string  with  2  words) 

Record  (3a),  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

noteText  (character  string) 

noteText  Text  of  note.  Multiple  lines  can  be  entered. 

Record  (3b),  End  of  Note 

Input  Records  (3)  to  (3b)  can  optionally  be  used  together  to  give  a  descriptive 
note  regarding  input. 

“end  note”  (1  character  string  with  2  words) 
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Record  (4),  Ship  Dimensions 

“shipDimensions” ,  lpp,  stationAP,  distanceFPCG,  draftBIMid  trimBIStern, 
shipKG  (1  character  string,  6  floats) 


“shipDimensions” 

lpp 

stationAP 

distanceFPCG 

draftBIMid 

trimBIStern 

shipKG 


Record  tag. 

Ship  length  between  perpendiculars. 

Station  number  for  aft  perpendicular  (typically  20.0). 

Distance  from  fore  perpendicular  to  longitudinal  centre  of 
gravity  (LCG)  (m). 

Draft  of  baseline  at  midships  (m). 

Trim  of  baseline  by  stern  (m). 

ffeight  of  centre  of  gravity  above  baseline  (m). 


Record  (5),  Name  of  File  with  Motion  Response  Amplitude  Operations 

“moDefRaoDBFileName”,  moDefRaoDBFileName  (2  character  strings) 
“moDefRaoDBFileName”  Record  tag. 

moDefRaoDBFileName  Name  of  file  with  ship  motion  and  appendage 

deflection  response  amplitude  operators.  This  file  is 
typically  built  using  application 
SM3DSeakeepRegular3  or  SM3DSeakeepRandom3. 


Record  (6),  Fixed  Seaway  XML  File  Name 

“fixedSeawayFileName” ,  fixedSeawayFileName  (2  character  strings) 
“fixedSeawayFileName”  Record  tag. 

fixedSeawayFileName  Name  of  XML  file  with  seaway  in  earth-fixed  axes. 

This  file  is  typically  built  using  application 
SM3DBuildSeaway3. 
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Record  (6a),  Motion  Axes  Output  Option 

“motionAxesOutputOption”,  motionAxesOutputOption  (2  character  strings) 
“motionAxesOutputOption”  Record  tag. 

motionAxesOutputOption  TransEarth  -  Output  values  are  given  in 

translating  earth  axes.  For  seakeeping  positions, 
values  are  given  relative  to  their  position  when  the 
ship  is  moving  at  speed  in  calm  water. 

EarthFixed  -  Output  values  are  given  in 
earth-fixed  axes. 


Record  (7),  Output  Ship  Motion  Time  Interval  and  Options 

“outTimeSeries” ,  outDispOption,  outVelOption,  outAccOption  (4  character 
strings) 


“outTimeSeries” 

outDispOption 


outVelOption 


outAccOption 


Record  tag. 

Option  for  giving  output  ship  displacements: 
Disp  -  Output  displacements  are  given. 
NoDisp  -  No  output  displacements  are  given. 
Option  for  giving  output  ship  velocities: 

Vel  -  Output  velocities  are  given. 

NoVel  -  No  output  velocities  are  given. 
Option  for  giving  output  ship  accelerations: 
Acc  -  Output  accelerations  are  given. 

NoAcc  -  No  output  accelerations  are  given. 


Record  (8),  Beginning  of  Seakeeping  Position  Data 

This  record  is  optional. 

“begin  seakeepPositions”  (1  character  string  with  2  words) 

Note:  If  this  record  is  entered,  then  it  can  be  followed  by  an  arbitrary  number 
of  repetitions  of  Records  (8a)  to  (8c)  giving  seakeeping  position 
parameters.  Record  (8d)  must  follow  at  the  end  of  all  seakeeping 
position  data. 
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Record  (8a),  Seakeeping  Position  Label 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 

“labelPos”,  labelPos  (2  character  strings) 

“labelPos”  Record  tag. 

labelPos  Label  for  seakeeping  position.  This  can  include  spaces. 

Record  (8b),  Seakeeping  Position  Location 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 

“locationPos”,  stationPos,  yPos,  zBIPos  (1  character  string,  3  floats) 

“locationPos”  Record  tag. 

stationPos  Station  for  seakeeping  position.  Station  0  is  at  the  fore 
perpendicular. 

yPos  Lateral  coordinate  (+  port)  relative  to  ship  centreline  (m). 

zBIPos  Vertical  coordinate  (+  up)  relative  to  ship  baseline  (m). 

Record  (8c),  Seakeeping  Position  Output  Options 

This  record  is  required  if  a  seakeeping  position  is  being  specified. 

“posOutputOptions”,  outDispPosOption,  outVelPosOption,  outAccPosOption, 
outRelMotionPosOption  (5  character  strings) 

“posOutputOptions”  Record  tag. 

outDispPosOption  Disp  -  Displacements  at  position  are  written  to  output. 

NoDisp  -  No  displacements  are  written  to  output. 

outVelPosOption  Vel  -  Velocities  at  position  are  written  to  output. 

NoVel  -  No  velocities  are  written  to  output. 

outAccPosOption  Acc  -  Accelerations  at  position  are  written  to  output. 

NoAcc  -  No  accelerations  are  written  to  output. 

outRelMotionPosOption  RelMotion  -  Relative  vertical  displacements  and 

velocities  at  position  are  written  to  output. 

NoRelMotion  -  No  relative  vertical  displacements  or 
velocities  at  position  are  written  to  output. 
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Record  (8d),  End  of  Seakeeping  Position  Data 

This  record  is  required  if  Record  (8)  is  present. 

“end  seakeepPositions”  (1  character  string  with  2  words) 

Record  (9a),  Ship  Speed 

One  of  Records  (9a),  (9b),  (9c)  must  be  given. 

“speed”,  speed  (1  character  string,  1  float) 

“speed”  Record  tag. 
speed  Ship  speed  (m/s). 

Record  (9b),  Ship  Speed  in  Knots 

One  of  Records  (9a),  (9b),  (9c)  must  be  given. 

“speedKnots” ,  speedKnots  (1  character  string,  1  float) 

“speedKnots”  Record  tag. 
speedKnots  Ship  speed  (knots). 

Record  (9c),  Ship  Froude  Number 

One  of  Records  (9a),  (9b),  (9c)  must  be  given. 

“Froude”,  Froude  (1  character  string,  1  float) 

“Froude”  Record  tag. 

Froude  Ship  Froude  number. 

Record  (10),  Ship  Heading 

“heading”,  shipHeadingToMeanDeg  (1  character  string,  1  float) 

“heading”  Record  tag. 

shipHeadingToMeanDeg  Mean  ship  heading  (to,  deg).  The  heading  is  0°  for  the 

ship  heading  north,  and  90°  for  the  ship  heading  east. 
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Record  (11),  Initial  Ship  Position 

“shipPositionO” ,  xfO,  yfO  (1  character  string,  2  floats) 
“shipPositionO”  Record  tag. 

xfO  Initial  x?  position  of  ship  at  time  tO  (m). 

yfO  Initial  y?  position  of  ship  at  time  tO  (m). 

Record  (12),  Time  Parameters 

“timeParameters” ,  tO,  tEnd,  dt  (1  character  string,  3  floats) 
“timeParameters”  Record  tag. 
tO  Time  at  start  of  time  series(s). 

tEnd  Time  at  end  of  time  series(s). 

dt  Time  increment  (s). 

Record  (13),  End  Record 

“end  SM3DTimeSeriesFromRaos3”  (1  character  string  with  2  words) 


282 


DRDC  Atlantic  TM  2011-308 


G.2  Sample  Input  File  for  SM3DTimeSeriesFromRaos3 

begin  SM3DTimeSeriesFromRaos3 
label  Generic  frigate 

shipDiraensions  120  20  61.7501556572279  4.2  0  6 

moDefRaoDBFileName  genFrigSeakeepRandomMoDefRaoDB.bin 

f ixedSeawayFileName  bretSeaState5Seaway . xml 

motionAxesOutputOption  TransEarth 

outTimeSeries  Disp  NoVel  Acc 

speedKnots  20 

heading  30 

shipPositionO  0  0 

timeParameters  0  40  0.2 

end  SM3DTimeSeriesFromRaos3 
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G.3  Sample  Output  File  for 

SM3DTimeSeriesFromRaos3  (Accelerations 
Removed) 

Program  SM3DTimeSeriesFromRaos3 

ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Time  :  November-10-11  2:05:19  PM 
Run  label : 

Generic  frigate 

****  ECHO  OF  USER  INPUT  **** 

Ship  Dimensions 
Length  between  perpendiculars 
Station  number  of  aft  perpendicular 
Distance  from  fore  perpendicular  to  LCG 
Draft  of  baseline  at  midships 
Trim  of  baseline  by  stern 
Height  of  CG  above  baseline 

File  name  with  ship  motion  RAOs  : 
genFrigSeakeepRandomMoDef RaoDB .bin 
Label  :  Generic  frigate 
Created  :  November- 10- 11  9:07:44  AM 

Version  :  ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Class  :  ShipMo3D.FreqDomain.MotionDeflectRaoDB 

File  name  with  seaway  in  earth-fixed  axes  : 
bretSeaState5Seaway . xml 

Label  :  Hs  =  3.25  m,  Tp  =  9.7  s,  Bretschneider  spectrum 
Created  :  November-10-11  2:05:19  PM 

Version  :  ShipMo3D  3.0  Version  3.0  release  -  5  October  2011 
Class  :  ShipMo3D . DeepSeaway . FixedMultiSeaway 

Motion  axes  output  option  :  TransEarth 

Options  for  writing  ship  motion  time  series  to  output  file 


Displacements  :  Disp 

Velocities  :  NoVel 

Accelerations  :  Acc 

Ship  speed  :  20.000  knots 

Ship  heading  (to)  :  30.000 


Initial  Ship  Position  in  Earth-fixed  Axes 
xfO  :  0.000  m 

yfO  :  0.000  m 

Time  Parameters 


120.000  m 
20.000 
61.750 
4.200  m 
0.000  m 
6.000  m 
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Start  time 
End  time 
Time  increment 


0.000  s 
40.000  s 
0.200  s 
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Displacements  at  Ship  CG  in  Translating  Earth  Axes 
Surge  +  forward 
Sway  +  port 
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Roll  (deg)  -0.009  0.757  1.677  -1.834  5.667 
Pitch  (deg)  -0.010  1.347  3.354  -3.247  5.667 
Yaw  (deg)  0.004  0.187  0.459  -0.431  5.400 
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not  necessary  to  include  here  abstracts  in  both  official  languages  unless  the  text  is  bilingual.) 

ShipMo3D  is  an  object-oriented  library  with  associated  user  applications  for  predicting  ship  mo¬ 
tions,  with  Version  3  introducing  modelling  of  sloshing  tanks  and  U-tube  tanks.  This  report 
serves  as  a  user  manual  for  ship  motion  predictions  in  the  time  and  frequency  domains  us¬ 
ing  ShipMo3D  Version  3.  A  companion  report  serves  as  a  user  manual  for  building  ship  models 
that  are  used  as  input  for  ship  motion  predictions.  Time  domain  simulations  can  model  a  freely 
maneuvering  ship  in  calm  water  or  in  waves.  SM3DBuildSeaway  builds  seaway  models  repre¬ 
senting  regular  or  random  seaways,  including  long  and  short-crested  seaways.  SM3DFreeMo 
simulates  a  freely  maneuvering  ship  in  calm  water  or  in  a  modelled  seaway.  Several  ShipMo3D 
applications  predict  ship  motions  in  the  frequency  domain  for  a  ship  with  quasi-steady  speed 
and  heading.  SM3DSeakeepRegular  predicts  motions  in  regular  waves.  The  applications 
SM3DSeakeepRandom,  SM3DSeakeepSeaway,  and  SM3DSeakeepSeawayFromRaos  predict 
motions  in  random  waves.  SM3DTimeSeriesFromRaos  produces  ship  motion  time  series  for 
a  ship  with  quasi-steady  speed  and  heading  based  on  previously  predicted  motion  response 
amplitude  operators. 


14.  KEYWORDS,  DESCRIPTORS  or  IDENTIFIERS  (Technically  meaningful  terms  or  short  phrases  that  characterize  a  document  and  could 
be  helpful  in  cataloguing  the  document.  They  should  be  selected  so  that  no  security  classification  is  required.  Identifiers,  such  as 
equipment  model  designation,  trade  name,  military  project  code  name,  geographic  location  may  also  be  included.  If  possible  keywords 
should  be  selected  from  a  published  thesaurus,  e.g.  Thesaurus  of  Engineering  and  Scientific  Terms  (TEST)  and  that  thesaurus  identified. 
If  it  is  not  possible  to  select  indexing  terms  which  are  Unclassified,  the  classification  of  each  should  be  indicated  as  with  the  title.) 
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